NestJS本地服务请求本地Express服务报connect ECONNREFUSED错误

核心现象 #

• 本地运行的NestJS服务向同机部署的Express服务发起请求时，抛出connect ECONNREFUSED错误
• 用Postman直接请求Express接口可正常得到响应，NestJS请求非本地公网/局域网地址时无异常，仅访问localhost地址时触发报错

按优先级排查修复 #

• 优先修复localhost解析问题（90%以上同类问题根因）
  大部分Node.js服务启动时默认绑定IPv4回环地址127.0.0.1，但部分HTTP客户端会默认将localhost解析为IPv6回环地址::1，两个地址不互通就会触发连接拒绝。
  直接将NestJS侧请求配置里的localhost替换为127.0.0.1即可，例如将请求地址从http://localhost:3000/xxx改为http://127.0.0.1:3000/xxx。

• 检查Express服务监听配置
  打开Express服务启动代码，确认listen方法的host参数配置正确：

  • 若要允许本地+同局域网其他设备访问，配置为app.listen(你的端口, '0.0.0.0')
  • 若仅允许本地访问，配置为app.listen(你的端口, '127.0.0.1')
    不要省略host参数、也不要绑定到特定物理网卡的IP，避免回环网卡无法访问。

• 排查代理配置干扰
  如果你在NestJS侧用Axios（含@nestjs/axios封装）、node-fetch等客户端发请求，检查是否配置了全局HTTP代理：

  • 系统开了全局代理/VPN时，部分客户端会默认将所有流量转发到代理端口，本地回环流量不会被代理处理就会报连接拒绝
  • 针对本地请求可以给客户端加proxy: false配置，或者在启动NestJS服务时设置环境变量NO_PROXY=localhost,127.0.0.1绕过代理。

• 排查启动时序问题
  如果NestJS和Express是通过同一启动脚本并行拉起，大概率是NestJS发起请求时Express还没完成端口监听，触发连接拒绝。可以加简单的健康检查逻辑，轮询Express的健康接口确认服务完全启动后，再发起业务请求。

快速验证流程 #

• 先在终端执行curl http://127.0.0.1:你的Express服务端口，确认接口本身可正常响应
• 替换NestJS侧请求地址为127.0.0.1后重试
• 仍报错就临时关闭系统代理、VPN类软件后再测试

内容的提问来源于stack exchange，提问作者Umar Khalid