调整worker_processes为8后Docker Nginx仍报worker_connections不足如何解决

多worker进程未生效排查 #

• 确认配置已正确挂载生效：Docker部署的Nginx需确认你修改的nginx.conf已经正确挂载到容器内的/etc/nginx/nginx.conf路径，避免修改宿主机文件未同步到容器。修改配置后需执行docker restart <nginx容器名称>重启容器，或进入容器执行nginx -s reload重载配置，重载后可执行nginx -T确认运行时配置已经更新为8 worker进程。
• 排查容器CPU限制：检查Nginx容器启动参数是否配置了CPU限制，比如docker run命令的--cpus 1参数、docker-compose配置中的cpus: 1字段，都会限制容器只能使用1核CPU，导致Nginx无法启动多个worker进程。
• 确认进程状态判断准确：执行docker exec <nginx容器名称> ps aux | grep nginx查看容器内的Nginx进程，不要直接用宿主机htop筛选，避免进程筛选规则错误导致误判多进程未运行。

worker_connections不足修复 #

注意：如果多worker进程未生效，实际只有1个worker运行，可承载的并发请求仅为2000左右，很容易触发该报错。

• 调整容器文件句柄限制：Nginx连接数受限于系统最大打开文件数限制，Docker容器默认的ulimit nofile通常为1024，远低于配置需求。启动容器时添加参数调高限制：

  docker run --ulimit nofile=65535:65535 <其他原有启动参数>
  

  如果使用docker-compose，则在服务配置下添加：

  ulimits:
    nofile:
      soft: 65535
      hard: 65535
  

• 调整连接数配置：Nginx作为反向代理时，每个客户端请求会占用2个连接（1个接收客户端请求，1个转发到后端Rails服务），你当前配置的单worker 4048连接，8个worker总承载并发请求仅为 8 * 4048 / 2 = 16192，如果性能测试并发量超过该值就会触发报错，可将worker_connections调整到10240甚至更高，匹配压测需求。

可选优化项 #

• 将worker_processes 8改为worker_processes auto，Nginx会自动匹配可用CPU核心数，无需手动指定。
• 在events块中添加use epoll;，启用Linux平台高性能事件处理模型，提升并发处理效率。
• 调低不必要的keepalive_timeout，或为后端Rails的upstream配置添加keepalive参数，复用Nginx到后端的TCP连接，减少连接开销和占用。
• 关闭不需要的access_log，或调整为异步写入，减少IO阻塞对并发的影响。

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