You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何修复启动Nx react+express项目时的代理ECONNREFUSED报错

报错信息

[webpack-dev-server] [HPM] 将localhost:4200/api的请求代理到http://localhost:3333/时发生错误 [ECONNREFUSED]
该错误含义为连接被拒绝,代理配置指向的目标地址没有可访问的服务在运行。

问题场景

基于Nx创建的React+Express技术栈应用,启动前端服务时触发上述报错。
问题报错截图

根因说明

报错的核心是前端开发服务器配置的/api路径代理目标http://localhost:3333无法连通,绝大多数情况是启动前端服务时,3333端口对应的Express后端服务没有启动——Nx默认不会在启动单前端应用时自动拉起依赖的后端服务。

解决方法
  • 先核对后端服务端口:检查Express应用的配置(对应Nx项目的project.json中serve配置项的端口、或项目内.env配置的端口),确认后端服务实际监听端口确实是3333,避免端口配置不匹配。
  • 按顺序启动服务:先在Nx工作区根目录执行后端服务启动命令,若后端应用名为api则执行nx serve api,等终端提示后端服务成功监听3333端口后,再新开终端执行前端的serve命令启动React应用。
  • 配置一键启动双服务:不想每次开两个终端手动启动的话,可以直接用Nx的多任务并行启动命令,替换原来的单前端启动命令:nx run-many -t serve -p 你的React应用名 你的Express应用名 --parallel,执行后会同时拉起前后端服务。
  • 特殊情况排查:如果确认后端已经启动在3333端口还是报错,先检查本地防火墙、代理软件有没有拦截本地端口访问,也可以把代理配置里的目标地址从http://localhost:3333改成http://127.0.0.1:3333,排除localhost域名解析异常的问题。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.08.27 01:27:24