0

0

如何正确处理 Fetch 请求中 Express 渲染的 EJS 错误页面

碧海醫心

碧海醫心

发布时间:2026-03-08 11:42:11

|

750人浏览过

|

来源于php中文网

原创

使用 fetch 发起 put/delete 等非表单方法请求时,即使 express 后端成功渲染了 ejs 错误页并返回 html 响应,浏览器也不会自动跳转或显示该页面——必须在前端显式解析并注入响应 html。

使用 fetch 发起 put/delete 等非表单方法请求时,即使 express 后端成功渲染了 ejs 错误页并返回 html 响应,浏览器也不会自动跳转或显示该页面——必须在前端显式解析并注入响应 html。

在现代 Web 开发中,通过 JavaScript 的 fetch 替代原生表单提交(以支持 PUT、DELETE 等方法)已成为常见实践。但一个容易被忽视的关键点是:fetch 是纯 API 交互机制,它不会触发浏览器默认的 HTML 导航行为。这意味着,即使后端使用 res.render() 返回了一个完整的 EJS 页面(如 ./userpages/error.ejs),只要前端未主动处理该 HTML 响应体,页面就不会更新——用户仍停留在原表单页,仅能在 DevTools 的 Network 面板中看到已返回的 HTML 内容。

问题本质:Fetch 不会自动导航,HTML 响应需手动注入

当你的 Express 错误中间件执行:

res.status(400).render('./userpages/error', { /* data */ });

它确实向客户端发送了状态码为 400、Content-Type: text/html 的完整 HTML 响应。但 fetch() 默认将响应视为“数据流”,而非“导航指令”。浏览器仅在以下场景自动导航:

  • 原生
    提交;
  • window.location.assign() 或重定向响应(如 302 + Location header)。

而你的 fetch 链中仅调用了 .json(),这会导致对 HTML 响应抛出 TypeError: Response body is not JSON,进而进入 .catch(),错误页面自然无法呈现。

正确解决方案:按响应类型分支处理

你需要在 fetch().then() 中根据 response.ok(即状态码是否在 200–299 范围)判断响应性质,并分别处理:

Veed AI Voice Generator
Veed AI Voice Generator

Veed推出的AI语音生成器

下载
fetch(this.action, {
  method: "PUT",
  body: JSON.stringify(formData),
  headers: {
    "Content-Type": "application/json;charset=utf-8",
  },
})
.then((response) => {
  if (response.ok) {
    // ✅ 成功:预期返回 JSON,跳转或提示
    return response.json().then((data) => {
      alert(data.message);
      window.location.href = '/user'; // 推荐使用 href 而非 location(更明确)
    });
  } else {
    // ❌ 失败:预期返回 HTML 错误页,注入 body
    return response.text().then((html) => {
      document.open();           // 清空当前文档(可选,提升可靠性)
      document.write(html);      // 写入服务端渲染的完整 HTML
      document.close();          // 关闭写入流,触发解析
    });
  }
})
.catch((err) => {
  console.error("Fetch failed:", err);
  alert("网络请求失败,请检查连接或重试");
});

关键点说明

  • response.ok 是比手动判断 response.status >= 400 更语义化、更健壮的方式;
  • 使用 response.text() 而非 response.json() 解析 HTML 响应,避免解析错误;
  • document.write() 在现代应用中需谨慎,但在此类全量页面替换场景下是合理且高效的选择(等价于服务端直出导航);
  • 若需保留部分当前页面结构(如导航栏),可改用 document.body.innerHTML = html 并确保 EJS 模板只输出 内容(配合 res.render() 的局部视图设计)。

进阶建议:统一响应格式(API 优先设计)

虽然上述方案可立即解决问题,但从架构一致性出发,更推荐采用 前后端职责分离 模式:

  • ✅ 后端始终返回结构化 JSON(含 success: boolean, message, redirect?, html?);
  • ✅ 前端统一处理 JSON,由 JS 控制 UI 行为(如 if (data.redirect) window.location = data.redirect);
  • ✅ 错误页也通过前端路由(如 React Router / Vue Router)动态加载,而非服务端渲染。

这样既能规避 fetch 与 HTML 导航的耦合,又利于后续演进为 SPA 架构。

总结

场景 是否自动导航 正确处理方式
原生表单 POST/GET ✅ 是 无需 JS 干预
fetch + res.json() ❌ 否 .json() 解析后手动跳转/提示
fetch + res.render()(HTML) ❌ 否 .text() 获取 HTML 后 document.write() 或 innerHTML 注入

记住:fetch 是数据获取工具,不是导航工具。当你混合使用服务端渲染(SSR)与客户端交互逻辑时,必须显式桥接二者——这是全栈开发中不可绕过的底层约定。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
什么是中间件
什么是中间件

中间件是一种软件组件,充当不兼容组件之间的桥梁,提供额外服务,例如集成异构系统、提供常用服务、提高应用程序性能,以及简化应用程序开发。想了解更多中间件的相关内容,可以阅读本专题下面的文章。

182

2024.05.11

Golang 中间件开发与微服务架构
Golang 中间件开发与微服务架构

本专题系统讲解 Golang 在微服务架构中的中间件开发,包括日志处理、限流与熔断、认证与授权、服务监控、API 网关设计等常见中间件功能的实现。通过实战项目,帮助开发者理解如何使用 Go 编写高效、可扩展的中间件组件,并在微服务环境中进行灵活部署与管理。

225

2025.12.18

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

453

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

546

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

331

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

Node.js后端开发与Express框架实践
Node.js后端开发与Express框架实践

本专题针对初中级 Node.js 开发者,系统讲解如何使用 Express 框架搭建高性能后端服务。内容包括路由设计、中间件开发、数据库集成、API 安全与异常处理,以及 RESTful API 的设计与优化。通过实际项目演示,帮助开发者快速掌握 Node.js 后端开发流程。

403

2026.02.10

java中boolean的用法
java中boolean的用法

在Java中,boolean是一种基本数据类型,它只有两个可能的值:true和false。boolean类型经常用于条件测试,比如进行比较或者检查某个条件是否满足。想了解更多java中boolean的相关内容,可以阅读本专题下面的文章。

366

2023.11.13

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

23

2026.03.06

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 10万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 3.3万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号