nginx 平滑重载通过主进程(master)与子进程(worker)分离的架构,配合文件描述符继承机制,保证长连接不断开。具体做法是:新 worker 进程启动时自动继承监听套接字(listening sockets),旧 worker 进程在处理完现有连接后优雅退出,期间不关闭已建立的连接。

为什么 Nginx 能实现无感重启
核心在于 Master-Worker 模型和 Unix 的文件描述符传递特性。当执行 `nginx -s reload` 时,Master 进程会编译新的配置并生成新的二进制程序,然后 fork 出新的 Worker 进程。由于 Linux 内核的特性,子进程会继承父进程打开的所有文件描述符,包括监听端口。因此,新 Worker 可以直接复用这些端口来接受新连接,而无需重新绑定或等待 TIME_WAIT。

master_process on;
events {
worker_connections 1024;
}
http {
server {
listen 80;
location / {
proxy_pass http://backend;
}
}
}
上述配置中,master_process on; 启用了多进程模式。当发送 SIGHUP 信号时,Master 进程保持运行,负责管理 Worker 进程的生命周期。旧的 Worker 进程在收到退出指令后,会停止接受新连接,但会继续处理已经接受的连接,直到所有连接关闭或超时,然后才退出。新 Worker 进程则立即开始使用继承来的监听套接字接受新请求。
新旧 Worker 如何切换连接
在重载过程中,Nginx 采用“先启后停”的策略。新 Worker 进程启动后,立即开始从监听套接字中 accept() 新的客户端连接。与此同时,旧 Worker 进程不再调用 accept(),而是继续处理其之前已经 accept() 下来的连接上的数据读写。这种机制确保了在配置变更或版本升级的瞬间,正在进行的 HTTP 长连接(如 WebSocket 或 Keep-Alive)不会中断,因为旧 Worker 仍然持有这些连接的 socket 描述符并负责维护它们。

// 伪代码逻辑示意 // Master 进程 fork() -> New Worker; New Worker inherits listening sockets; Old Worker stops accept(); Old Worker processes existing connections until close; Old Worker exits; // Client 视角 Client sends request -> New Worker accepts (if after reload); Existing connection -> Old Worker handles (until finish);
这种切换过程对客户端完全透明。如果客户端在重载瞬间发起新请求,它会被分配给新 Worker;如果客户端已有活跃连接,该连接仍由旧 Worker 服务,直到自然断开。这避免了因重启导致的连接重置(RST)包发送,从而保证了业务的连续性。
基于 worker_shutdown_timeout 的具体问题
如果在重载过程中,旧 Worker 需要长时间处理某些慢查询或大文件传输,如何确保它最终能退出而不阻塞整个系统?可以通过设置 worker_shutdown_timeout 参数来解决。该参数指定了旧 Worker 进程在停止接受新连接后,最多允许处理多长时间的业务。如果超过这个时间,Nginx 会强制终止该 Worker 进程,即使还有未完成的连接。这防止了因个别长连接导致的新旧 Worker 无法顺利交接,从而避免服务假死或资源耗尽。











