在 nginx 中实现不中断长连接(如 websocket、http keep-alive)的平滑重载,核心做法是向主进程发送 sigusr2 信号触发新进程启动,随后通过 sigwinch 信号逐步关闭旧工作进程。该机制利用 nginx 的多进程架构,让新旧版本共存,确保正在处理请求的连接不被强制断开。

如何执行完整的信号流程
执行平滑重载需要按顺序发送三个关键信号:先通知主进程启动新版本,再停止接收新连接的旧主进程,最后优雅退出旧工作进程。具体操作是通过 shell 命令读取 PID 文件并调用 kill 命令。

#!/bin/bash # 假设 Nginx 安装路径为 /usr/local/nginx NGINX_BIN="/usr/local/nginx/sbin/nginx" PID_FILE="/usr/local/nginx/logs/nginx.pid" # 1. 发送 SIGUSR2 给当前主进程,触发升级 # 这会生成一个新的 master.pid 和 worker 进程 kill -s USR2 `cat $PID_FILE` # 2. 等待新进程完全启动(可选,视业务负载而定) sleep 2 # 3. 发送 WINCH 给旧的主进程 # 这会让旧的主进程开始优雅地关闭其下属的旧 worker 进程 kill -s WINCH `cat $PID_FILE.oldbin`
上述脚本执行后,Nginx 的状态变化如下:旧的 Master 进程收到 SIGUSR2 后,会重新加载配置文件并启动新的 Master 进程。此时系统中存在两个 Master 进程。接着发送 SIGWINCH 给旧的 Master,它不会立即退出,而是向其下的所有 Worker 发送 SIGTERM,Worker 在处理完当前请求后退出。当所有旧 Worker 都退出后,旧 Master 进程也会随之退出,最终只留下新的 Master 和新 Worker。
如何处理回滚或异常情况
如果在平滑重载后发现新版本配置有误或出现严重 Bug,需要立即回滚到旧版本,可以通过向旧的主进程发送 HUP 信号来实现。这个操作会让旧的主进程重新加载配置文件并重启其 Worker 进程,同时保持新进程继续运行但不再接收新连接(或者根据具体情况,通常建议先停止新进程)。

# 如果重载失败,需要回滚 OLD_MASTER_PID=$(cat /usr/local/nginx/logs/nginx.pid.oldbin) # 1. 让旧的主进程重新加载配置并重启 Worker kill -s HUP $OLD_MASTER_PID # 2. 此时旧 Worker 已经重启并准备就绪,可以安全地关闭新进程 NEW_MASTER_PID=$(cat /usr/local/nginx/logs/nginx.pid) # 3. 发送 QUIT 给新主进程,使其立即退出 kill -s QUIT $NEW_MASTER_PID
回滚流程的关键在于保留旧版本的进程状态。当发送 HUP 给旧 Master 时,它会像初始启动一样重新初始化 Worker。由于旧版本的二进制文件和配置文件通常还在磁盘上(除非被覆盖),它们能迅速恢复服务。此时,新版本的 Master 进程仍然存在,但为了彻底回滚,我们使用 SIGQUIT 直接终止新 Master,从而将流量完全交还给旧版本。这种机制确保了即使在部署过程中出错,也能以极小的代价恢复到稳定状态。
基于 worker_shutdown_timeout 的具体问题
在平滑重载过程中,如果某个 Worker 进程因为持有大量长连接而无法在短时间内关闭,Nginx 默认会等待多久?这个行为由 worker_shutdown_timeout 参数控制。
默认情况下,Nginx 并没有设置 worker_shutdown_timeout,这意味着如果旧 Worker 无法优雅关闭(例如仍有活跃连接),它将无限期等待,直到连接全部断开。这对于长连接场景可能导致重载过程卡住很久。为了解决这个问题,可以在 nginx.conf 中设置一个超时时间,例如 worker_shutdown_timeout 60s;。当旧 Worker 收到退出信号后,如果在 60 秒内仍有活跃连接,Nginx 将强制关闭这些连接并退出 Worker,从而保证重载流程能够按时结束。这个参数对于 WebSocket 等长连接服务尤为重要,因为它避免了因个别僵死连接导致整个集群无法完成版本切换的问题。











