Docker容器化Node.js应用访问报ECONNREFUSED错误如何解决？

问题根因 #

• 启动命令覆盖了应用启动逻辑：你在docker run命令末尾添加的tail -f /dev/null会直接覆盖Dockerfile中定义的CMD npm start，容器启动后只会运行tail命令，你的Node服务根本没有启动，自然无法响应请求。
• 端口映射不匹配：你的server.js中默认端口为3000，仅当存在PORT环境变量时才会使用指定端口，你当前没有给容器传递PORT=5000的环境变量，就算服务正常启动，也会运行在3000端口，和你映射的容器侧5000端口不匹配。
• 可选遗漏配置：express默认监听127.0.0.1时，仅支持容器内部访问，外部网络无法请求到容器内服务。

修复步骤 #

1. 先删除现有异常容器：

docker rm -f fixit-container

2. （可选优化）修改server.js监听逻辑，绑定0.0.0.0支持外部访问：

const app = require('./api/src/app');

const port = process.env.PORT || 3000; // PORT设置为5000

app.listen(port, '0.0.0.0', () => {
  console.log('App executing to port ', port);
});

3. 如果修改了代码，重新构建镜像：

docker build . -t fixit-server

4. 选择任意一种方案启动容器即可：
   • 方案1：传递PORT环境变量，匹配你之前的端口映射逻辑

   docker run -d -p 8000:5000 --name fixit-container -e PORT=5000 fixit-server
   

   • 方案2：直接映射到服务默认的3000端口，无需修改环境变量

   docker run -d -p 8000:3000 --name fixit-container fixit-server
   

5. 启动后执行docker logs fixit-container确认服务正常打印启动日志，再访问localhost:8000/api即可正常获取返回结果。

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