Node.js后端fetch()请求HTTP/localhost报Network request failed如何解决

适用场景：Node.js后端开发中，fetch()可正常拉取HTTPS站点数据，请求HTTP站点、localhost地址时报网络错误，已在package.json中配置"proxy": "http://localhost:5000"仍未解决问题。

核心误区先排查 #

• package.json中的proxy配置仅对前端构建工具（如Create React App、Vite）的开发服务器转发浏览器侧请求生效，Node.js后端进程中直接调用的fetch不会读取该配置项，这个配置从一开始就不会对你的后端请求生效。

按优先级逐项排查 #

• 先验证网络链路本身是否通畅
  直接在终端用curl 你的目标HTTP/localhost地址发起请求，如果curl也报错，先排查目标服务是否正常启动、端口是否正确监听、系统防火墙/安全软件是否拦截了对应请求，这类问题和fetch本身无关。
• 排查全局代理环境变量拦截
  大部分开发环境会配置HTTP_PROXY/HTTPS_PROXY全局代理（比如科学上网工具），这类代理默认不会放行localhost、本地HTTP明文请求，会直接拦截抛网络错误。启动Node.js服务时显式配置不走代理的地址列表即可：
  • Mac/Linux环境：启动命令前加NO_PROXY=localhost,127.0.0.1,::1，例：NO_PROXY=localhost,127.0.0.1,::1 node index.js
  • Windows cmd环境：启动前先执行set NO_PROXY=localhost,127.0.0.1,::1，再启动服务
  • Windows PowerShell环境：启动前先执行$env:NO_PROXY="localhost,127.0.0.1,::1"，再启动服务
• 检查fetch请求参数是否写错
  确认请求地址的协议、端口完全正确，不要给本地HTTP服务的地址加https://前缀，本地服务没配置TLS证书的话，HTTPS请求会直接握手失败抛错。
• 排查Node.js内置fetch的策略限制
  Node.js 18+内置的fetch基于undici实现，部分版本对明文HTTP请求、本地回环地址有默认安全限制。可以先安装node-fetch包做对照测试，如果node-fetch能正常请求，说明是内置fetch的限制，两种解决方式：
  1. 启动Node服务时加--no-experimental-fetch参数禁用内置fetch，引入node-fetch作为polyfill替换
  2. 继续用内置fetch/undici的话，显式配置请求的dispatcher，需要走代理的场景也通过这个方式配置，不要依赖package.json的proxy字段：

     const { ProxyAgent, fetch } = require('undici')
     // 配置你要走的本地代理
     const proxyAgent = new ProxyAgent('http://localhost:5000')
     // 请求时传入dispatcher
     const res = await fetch('http://你的目标请求地址', {
       dispatcher: proxyAgent
     })
     

内容的提问来源于stack exchange，提问作者Ryan j