为什么 Nginx 平滑重载会卡住
nginx nginx -s reload 卡住通常是因为主进程在等待旧工作进程(worker)处理完所有现有连接后,才允许其退出。如果客户端保持长连接(如 http keep-alive、websocket 或 grpc),或者后端服务响应缓慢导致 worker 无法释放连接,旧进程就会一直存活,导致重载操作挂起。要解决这个问题,需要检查并调整 keepalive_timeout 和 worker_shutdown_timeout 等参数,确保连接能正常关闭。

如何配置超时以加速重载
通过缩短 keepalive_timeout 可以强制客户端断开空闲连接,从而让旧 Worker 更快完成工作。同时,设置 worker_shutdown_timeout 可以为正在处理的请求设定一个宽限期,超过该时间后 Nginx 将强制终止旧进程,避免无限期等待。

events {
worker_connections 1024;
}
http {
# 设置空闲连接超时时间为 5 秒
keepalive_timeout 5s;
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
}
}
}
上述配置中,keepalive_timeout 5s 使得 Nginx 在 5 秒无活动后主动关闭连接。配合 worker_shutdown_timeout(需在 Nginx 1.9.0+ 版本中使用),可以控制重载时的行为:
events {
worker_connections 1024;
worker_shutdown_timeout 10s; # 等待 10 秒后强制关闭
}
当执行 nginx -s reload 时,Nginx 会发送信号给旧 Worker,告知它们停止接受新连接,并等待现有连接在 keepalive_timeout 结束后自然断开。如果在 worker_shutdown_timeout 时间内仍有活跃连接,Nginx 将强制关闭这些连接并退出旧进程。
基于程序中某个输入、条件或结果的具体问题
在实际操作中,如果后端服务响应极慢,即使设置了 keepalive_timeout,旧 Worker 仍可能因等待后端响应而无法退出。此时,worker_shutdown_timeout 成为关键参数。它定义了从收到退出信号到强制退出的最大等待时间。若未设置此参数,Nginx 可能会无限期等待,导致重载卡死。
例如,假设后端 API 响应时间为 30 秒,而 worker_shutdown_timeout 设置为 10 秒。当执行重载时,旧 Worker 会在 10 秒后强制关闭与后端的连接,即使请求尚未完成。这可能导致部分请求失败,但确保了重载操作的及时性。
验证这一行为的方法是使用 curl 模拟长连接请求,并观察 Nginx 的日志输出。在 access.log 中,可以看到连接被提前关闭的记录;在 error.log 中,可能会有“worker process shutting down”相关的提示。











