在 linux 中 nginx 平滑重载(reload)时,代理长连接 keepalive 的优雅关断依赖于主进程与子进程的握手机制。nginx 通过 unix domain socket 发送信号通知旧工作进程关闭新连接并等待现有连接处理完毕,同时停止接受新的客户端请求。这一过程确保了正在进行的 http 长连接能够自然结束或保持活跃,而不会因进程重启导致连接中断。

Nginx Reload 的信号传递流程是怎样的
Nginx 的平滑重载核心在于 Master 进程与 Worker 进程的协作。当执行 nginx -s reload 时,Master 进程会重新加载配置文件并启动新的 Worker 进程。随后,Master 通过 Unix Domain Socket 向旧的 Worker 进程发送 NGX_CMD_QUIT 命令。旧 Worker 收到该命令后,会立即停止监听新的客户端连接,但会继续处理当前已建立的连接。对于代理长连接,这意味着上游服务器与 Nginx 之间的 TCP 连接状态由 Nginx 控制,Nginx 可以选择保持这些连接以复用,或者在连接空闲时关闭它们。

events {
worker_connections 1024;
}
http {
upstream backend {
server 127.0.0.1:8080;
keepalive 32;
}
server {
listen 80;
location / {
proxy_pass http://backend;
proxy_http_version 1.1;
proxy_set_header Connection "";
}
}
}
上述配置展示了如何启用代理层的 Keepalive。关键参数 keepalive 32 定义了每个 Worker 进程与上游服务器之间保持的空闲连接池大小。配合 proxy_http_version 1.1 和清空 Connection 头部,Nginx 会与上游建立长连接。在 Reload 过程中,这些连接属于旧 Worker 进程的资源。旧 Worker 在收到退出指令后,会优雅地关闭这些连接,释放文件描述符,然后退出。新 Worker 启动后,会重新建立新的长连接池。
代理长连接在 Reload 期间的具体行为是什么
在 Reload 期间,代理长连接的行为取决于连接的状态。如果连接处于活跃数据传输中,旧 Worker 会完成当前请求的处理,然后关闭连接。如果连接处于空闲状态且仍在 Keepalive 超时时间内,旧 Worker 可能会保留该连接直到超时,或者在收到特定信号后立即关闭。Nginx 的设计目标是确保客户端感知不到服务端的进程切换,因此对于客户端到 Nginx 的连接,Nginx 会尝试将未完成的请求转发给新 Worker,但这通常涉及复杂的内存共享或重定向机制,而在标准的 Reload 中,更常见的是客户端连接被断开或保持原状由旧 Worker 处理完毕。

# 模拟测试脚本
for i in {1..10}; do
curl -s -o /dev/null -w "%{http_code}" http://localhost/ &
done
wait
nginx -s reload
sleep 2
# 检查旧进程是否完全退出
ps aux | grep nginx | grep -v grep
通过运行上述测试脚本,可以在 Reload 前后观察连接状态。在实际操作中,建议监控 Nginx 的错误日志,查看是否有大量的 upstream prematurely closed connection 或类似警告。这有助于判断 Keepalive 连接在 Reload 时的清理情况。如果需要更精细的控制,可以考虑使用 graceful shutdown 机制,即先停止接收新连接,等待所有现有连接处理完毕后,再手动终止进程,这种方式比 reload 更彻底,但需要业务侧的配合。
如何验证 Reload 后 Keepalive 连接池是否正常重建
验证 Keepalive 连接池的重建可以通过检查 Nginx 的状态模块或日志来实现。启用 stub_status 模块后,可以访问 /nginx_status 端点,查看当前的活动连接数和空闲连接数。Reload 后,新 Worker 会逐渐建立新的长连接到上游服务器。如果连接池未能正常重建,可能会导致性能下降,表现为每次请求都建立新的 TCP 连接。此外,可以通过 netstat 或 ss 命令查看 Nginx 进程与上游服务器之间的 TCP 连接状态,确认是否有大量的 TIME_WAIT 或 CLOSE_WAIT 状态,这通常意味着连接关闭不优雅。


















