Docker环境下Postman请求出现Error: socket hang up问题求助

1. 检查Node应用的监听地址 #

本地运行时绑定localhost或127.0.0.1仅能在本机访问，但Docker容器内部的localhost与宿主机不属于同一网络空间。必须将监听地址改为0.0.0.0，让应用接受所有网络接口的请求：

// 错误写法
app.listen(3000, 'localhost');
// 正确写法
app.listen(3000, '0.0.0.0');

2. 确认Docker端口映射配置 #

• Dockerfile中需声明应用监听的端口：

  EXPOSE 3000
  

• 启动容器时必须配置端口映射，关联宿主机端口与容器端口：

  docker run -p 3000:3000 your-image-name
  

  注意：冒号前为宿主机端口，后为容器内应用的监听端口，二者需对应。

3. 验证容器内应用是否正常启动 #

• 查看容器日志，确认应用未崩溃：

  docker logs <container-id>
  

• 检查Dockerfile的启动命令是否正确，生产环境建议直接用node启动而非nodemon（容器内无需热重载工具）：

  # 正确启动命令示例
  CMD ["node", "server.js"]
  

  若坚持使用nodemon，需确保nodemon已添加到package.json依赖中，且Docker构建时执行了npm install完成安装。

4. 排查网络与防火墙问题 #

• 检查宿主机防火墙是否允许访问映射端口（如3000），可临时关闭防火墙测试连通性。
• 尝试用宿主机IP而非localhost访问API，例如http://your-host-ip:3000/api/xxx。
• 若使用Docker的host网络模式，需确认应用监听端口未被宿主机其他进程占用。

5. 确认Docker构建时依赖安装完整 #

Dockerfile的构建顺序会影响依赖完整性，正确顺序为先复制依赖文件、安装依赖，再复制应用代码，避免代码更新导致依赖缺失：

FROM node:18-alpine

WORKDIR /app

# 先复制依赖配置文件
COPY package*.json ./
RUN npm install --production

# 再复制应用代码
COPY . .

EXPOSE 3000
CMD ["node", "server.js"]

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