NestJS使用常规fetch API时出现Failed to Fetch错误排查求助

问题背景 #

运行NestJS Web应用时出现Failed to Fetch错误，报错详情：

at /Users/2023/pp_project/gzb-services/node_modules/@nestjs/core/router/router-proxy.js:9:17 {
  response: 'TypeError: fetch failed',
  status: 500,
  options: undefined
}

已确认HTTP端点和本地网络（含VPN）无异常，以下是可能的原因及排查方向：

• 目标服务SSL证书异常
  若调用HTTPS接口，目标服务证书过期、自签名未被信任或证书链不完整，会导致Node.js的fetch请求失败。可临时在fetch配置中添加{ rejectUnauthorized: false }（仅测试用）验证，生产环境需配置正确的证书信任链。

• 目标服务超时或内部错误
  端点可用不代表服务能正常处理请求，目标服务可能因业务逻辑抛出未捕获异常、处理超时，导致无有效响应返回。建议给fetch添加超时控制（用AbortController），同时查看目标服务的日志排查内部错误。

• NestJS路由代理配置错误
  报错来自router-proxy.js，说明代理环节出问题。可能是代理请求头缺失（如Authorization、Content-Type）、请求体格式不匹配（比如目标服务需JSON但传了FormData且未设头）。检查代理模块（如@nestjs/axios）的配置项，核对请求参数是否符合目标服务要求。

• Node.js版本与fetch兼容性问题
  Node.js <18版本无原生fetch，若使用node-fetch等polyfill，可能与NestJS路由代理存在版本兼容问题。尝试升级Node.js到LTS版本，或确认polyfill版本与NestJS依赖匹配。

• 请求体过大或格式非法
  请求体包含超大文件、JSON格式错误（如未闭合引号、多余逗号），会导致目标服务断开连接触发fetch失败。检查请求体大小是否超出目标服务限制，验证数据格式合法性。

• 服务器端防火墙/安全组拦截
  本地网络正常不代表应用服务器能访问目标服务，目标服务所在服务器的防火墙或安全组可能拦截了应用IP。在应用服务器上用curl直接调用目标端点，确认是否能正常响应。

内容的提问来源于stack exchange，提问作者Shivam Sahil