nginx 平滑重载后旧进程残留通常是因为 worker 进程在收到信号后未能及时退出,或者因处理长连接导致优雅关闭(graceful shutdown)时间过长。要解决这个问题,需要确保 master 进程正确发送了 term 信号,并检查 worker 进程的退出逻辑。如果旧进程长时间不消失,可以通过调整 worker_shutdown_timeout 参数来强制终止超时进程,或者排查是否有阻塞退出的操作。

为什么 reload 后旧进程不会立即消失?
这是因为 Nginx 的 reload 机制是“优雅重启”。Master 进程启动新的 Worker 进程后,会向旧的 Worker 进程发送 TERM 信号。旧进程收到信号后,会停止接受新连接,但会继续处理完当前正在处理的请求,直到所有活动连接都关闭后才退出。这个过程确保了服务不中断,但也导致了旧进程在一段时间内依然存在。

master_process on;
worker_processes auto;
events {
worker_connections 1024;
}
http {
server {
listen 80;
location / {
proxy_pass http://backend;
}
}
}
上述配置中,master_process on; 启用了主进程模式。当执行 nginx -s reload 时,Master 进程会 fork 出新的 Worker 进程,并通知旧 Worker 进程退出。旧进程在处理完现有连接后才会真正消失。如果连接数很多或处理时间长,旧进程残留的时间就会变长。
如何强制快速清理残留的旧进程?
如果希望旧进程尽快退出,可以设置 worker_shutdown_timeout 参数。该参数指定了 Worker 进程在收到退出信号后,最多等待多长时间来处理完现有连接。如果超过这个时间,Nginx 会强制终止该进程。默认情况下,如果没有设置这个参数,Worker 进程会一直等待直到所有连接关闭,这可能导致残留进程长时间存在。

master_process on;
worker_processes auto;
worker_shutdown_timeout 5s;
events {
worker_connections 1024;
}
http {
server {
listen 80;
location / {
proxy_pass http://backend;
}
}
}
在上述配置中,worker_shutdown_timeout 5s; 设置了超时时间为 5 秒。当执行 nginx -s reload 时,旧 Worker 进程会在 5 秒后强制退出,即使还有未处理完的连接。这样可以避免旧进程长期残留,但可能会丢弃部分正在进行的请求。根据业务需求调整这个值,以平衡服务连续性和资源清理速度。
如果旧进程仍然残留,如何手动干预?
如果设置了超时时间后旧进程仍然残留,可能是由于进程处于僵死状态或被其他因素阻塞。此时可以手动查找并终止这些进程。使用 ps aux | grep nginx 命令查看当前的 Nginx 进程列表,识别出 PID 较旧的 Worker 进程。然后使用 kill -9 强制杀死这些进程。注意,不要杀死 Master 进程,否则会导致整个 Nginx 服务停止。
此外,检查系统日志和 Nginx 错误日志,看是否有异常信息提示进程无法退出。常见的原因包括文件描述符泄漏、锁文件冲突或后端服务无响应。解决这些问题后,重新执行 nginx -s reload,旧进程应该能正常退出。











