You need to enable JavaScript to run this app. fetch API接收500状态码时无法获取服务器错误且报JSON输入意外结束
优惠活动
大模型
产品
解决方案
定价
更多

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()强制解析失败
  • 你参考的示例默认假设「所有错误响应都是标准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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.25 11:45:03