fetch API接收500状态码时无法获取服务器错误且报JSON输入意外结束
错误原因
- 你遇到的
SyntaxError: Unexpected end of JSON input是JSON解析阶段抛出的原生错误,和业务逻辑无关,一旦触发,你的catch里拿到的是这个解析错误,完全没有携带服务端返回的实际内容,自然没法拿到你需要的错误信息。 - 触发这个错误的核心原因是你在错误分支里直接调用
res.json(),但服务端返回500状态时的响应体往往不满足JSON解析要求:- 场景1:服务端返回500时响应体完全为空,
res.json()没有可解析的内容,直接抛错 - 场景2:服务端返回500时的响应体不是JSON格式(比如Nginx/框架默认返回的HTML错误页、纯文本错误提示),
res.json()强制解析失败
- 场景1:服务端返回500时响应体完全为空,
- 你参考的示例默认假设「所有错误响应都是标准JSON格式」,这个前置假设在生产环境非常容易不成立——尤其是500属于服务端内部错误,很多时候还没走到业务层的统一错误拦截逻辑,就被网关、框架默认的错误处理逻辑返回了非JSON内容。
正确实现方案
- 不要直接对错误响应调用
res.json(),先读取响应的原始文本,再根据内容类型做兼容解析,避免解析错误直接抛异常丢失真实内容:
fetch(fetchUrl) .then(async res => { // 先取原始响应文本,不管是什么格式都先存下来 const rawText = await res.text(); // 正常响应逻辑 if (res.ok) { return rawText ? JSON.parse(rawText) : {}; } // 错误响应逻辑 let errInfo; // 判断内容类型,尝试解析JSON const isJson = res.headers.get('content-type')?.includes('application/json'); if (isJson && rawText) { try { errInfo = JSON.parse(rawText); } catch (e) { // 就算头标是JSON但内容不对,也兜底用原文 errInfo = { message: rawText, status: res.status }; } } else { // 非JSON格式的错误,直接用原文当错误信息 errInfo = { message: rawText || `服务端返回无内容的错误:${res.status}`, status: res.status }; } // 把标准化后的错误抛到catch里 return Promise.reject(errInfo); }) .then(data => { // 正常业务处理 }) .catch(err => { // 这里能拿到所有格式的服务端错误内容 console.log(err); });
- 补充说明:
- React技术栈不会对这个逻辑造成任何影响,fetch是浏览器原生API,上述代码可以直接用在React的自定义请求Hook、组件生命周期、状态管理逻辑里。
- 如果你可以调整服务端逻辑,建议统一所有错误响应的格式:返回JSON结构的错误信息,同时设置正确的
Content-Type: application/json响应头,能大幅减少前端的兼容处理成本。
内容的提问来源于stack exchange,提问作者Yossi Sternlicht
相关产品推荐
相关产品推荐

