You need to enable JavaScript to run this app. Gatsby请求本地服务报Unhandled Rejection Failed to fetch如何解决?
优惠活动
大模型
产品
解决方案
定价
更多

Gatsby请求本地服务报Unhandled Rejection Failed to fetch如何解决?

前端fetch请求Failed to fetch问题的排查与修正

核心问题定位

  • 请求地址格式不合法:代码里写的fetch('localhost:3005/auth')缺了http/https协议头,浏览器根本不会把这个识别成独立的后端地址,会自动把它拼在当前站点的域名后面发起请求,百分百连不到后端,直接触发Failed to fetch。
  • 硬编码本地开发地址导致线上失效:把只有本地开发能访问的localhost:3005写死在前端代码里,部署到Heroku之后,前端跑在公网域名下,这时候请求localhost:3005本质是访问浏览页面的用户自己电脑上的3005端口,根本碰不到你部署的后端,这就是为什么换了部署环境问题还在。
  • 前后端返回数据不匹配:后端/auth接口直接把签名字符串当响应返回,前端却写了result.data去取值,就算请求通了,拿到的也是undefined,根本存不到state里。
  • 后端路由的异常逻辑有问题:签名生成的try/catch块抓到错误之后,没有直接返回错误响应,还是会继续执行后面的res.json逻辑,如果Cloudinary的密钥配错了导致签名生成失败,接口会返回无效内容,前端拿不到合法JSON就会报错。
  • 请求链没有错误捕获:fetch的Promise后面没加catch,不管是网络断了、跨域被拦了、后端返回了非JSON内容,都会直接抛未处理的Rejection,连具体是啥错都看不到。

具体修正步骤

  • 把所有后端请求的地址换成带协议头的完整URL,不要硬编码本地端口。用Gatsby的环境变量管理接口地址:本地开发时在.env文件里配置本地后端的完整地址(比如GATSBY_SERVER_URL=http://localhost:3005),部署的时候在平台的环境变量里配线上后端的地址,代码里通过环境变量拼接请求路径,本地、线上都能正常匹配。
  • 对齐前后端的数据格式:要么把后端的接口响应改成res.json({ data: signature })匹配前端的取值逻辑,要么把前端的取值改成直接用接口返回的结果,不要硬取不存在的data字段。
  • 给后端路由补全异常处理:签名生成失败的时候,直接返回带状态码的错误响应,不要返回空内容;如果前后端是不同域名部署的,在CORS配置里指定允许访问的前端域名,别用默认的全开放配置,避免被浏览器安全策略拦截。
  • 给前端的fetch请求补全错误捕获:在Promise链最后加一个catch分支,把具体的错误信息打在控制台,不管是网络不通、跨域拦截还是后端服务挂了,都能快速定位原因。
  • 基础连通性排查:排查的时候先直接在浏览器地址栏输入后端的完整接口地址,确认能正常拿到返回的签名值,如果这一步都打不开,那问题肯定出在后端服务没启动、端口不对,和前端代码没关系。

内容的提问来源于stack exchange,提问作者Robert Jamborski

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.01 16:15:03