Docker环境下Nginx反向代理Express微服务随机超时问题求助

问题现象 #

团队基于Docker Compose搭建了包含3个Express API微服务、React前端、Nginx反向代理的开发环境，出现以下异常：

• 三个微服务同时接入Nginx时，必有一个服务挂起/超时，另外两个正常运行；任意两个微服务组合接入代理时，二者均能正常工作
• 仅一位同事的本地机器出现此问题，其余成员无异常
• 每个微服务单独运行、绕过Nginx直接访问端口均无报错

已完成排查 #

• 超时发生时，直接访问对应微服务的本地映射端口（如5001、5002），确认服务本身正常运行
• 移除任一微服务，仅保留两个接入代理，无超时问题
• 修改Nginx对外端口后，问题依然存在

排查方向 #

1. 本地Docker资源配额限制 #

因为问题仅出现在特定机器，优先排查本地Docker的资源分配是否不足：

• 打开Docker Desktop的Resources设置（Windows/Mac），检查CPU、内存、磁盘的分配额度，比如内存是否只分配了2GB（三个Node服务+Nginx+React前端可能会耗尽）
• 运行docker stats命令，实时监控所有容器的CPU、内存占用率，观察三个服务同时启动时是否有容器出现资源耗尽的情况
• 检查本地是否有其他高资源占用进程（如大型IDE、虚拟机），挤占Docker的可用资源

2. Nginx连接数与配置优化 #

检查Nginx的连接限制与日志，确认是否存在连接瓶颈：

• 修改Nginx配置，在http块下添加/调整连接参数：

  worker_processes auto;
  worker_connections 2048; # 从默认1024适当调高
  keepalive_timeout 65;
  

• 进入Nginx容器查看错误日志：

  docker exec -it nginx tail -f /var/log/nginx/error.log
  

  排查是否有连接超时、连接被拒绝的日志信息
• 给每个upstream节点添加容错参数，避免Nginx误判服务不可用：

  upstream api2 {
      server api2:5002 max_fails=3 fail_timeout=30s;
  }
  

3. Docker网络与端口冲突 #

排查Docker网络栈是否异常，或端口被本地进程占用：

• 检查本地端口占用情况：

  # macOS/Linux
  lsof -i :5001 && lsof -i :5002 && lsof -i :5003
  # Windows
  netstat -ano | findstr :5001
  

  确认微服务的映射端口未被其他本地进程占用
• 查看Docker网络状态：

  docker network inspect <你的项目目录名>_default
  

  确认三个微服务容器都在同一网络，IP地址正常
• 尝试重启Docker服务，重置网络栈后再重新启动所有容器

4. 微服务启动顺序与健康检查 #

当前depends_on仅保证Nginx容器启动，但不代表Nginx配置加载完成，可能存在服务就绪顺序问题：

• 在docker-compose中给微服务添加健康检查，确保服务就绪后再对外提供服务：

  api1:
    # 原有配置不变
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:5000/health"] # 需微服务提供健康检查接口
      interval: 10s
      timeout: 5s
      retries: 3
  

• 或者在微服务的启动脚本中添加延迟，等待Nginx完全就绪后再启动服务

5. Node.js文件描述符限制 #

开发模式下Node.js可能占用较多文件描述符，特定机器的系统限制可能不足：

• 修改微服务的Dockerfile，调高文件描述符限制：

  CMD ["sh", "-c", "ulimit -n 4096 && yarn dev"]
  

• 检查本地系统的文件描述符限制：

  # macOS/Linux
  ulimit -n
  

  若数值低于1024，需调高系统限制

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