nginx 实现后端优雅关机需配置主动健康检查、动态摘流、延长超时、保持长连接，并依赖后端主动切换探针状态、关闭新请求入口、等待连接归零；须通过 nginx -t、stub_status 和模拟下线验证闭环。
要让 Nginx 协助后端集群实现优雅关机，核心不是让 Nginx 自己“停下来”，而是让它及时感知某个后端节点即将退出，并停止转发新请求，同时给已在途的请求留出完成时间。这需要 Nginx 配置、健康探测机制、后端行为三者协同。
配置主动健康检查与动态摘流
Nginx 默认轮询不感知后端状态，必须显式启用主动探测才能快速识别下线意图：
- 在 upstream 块中添加健康检查指令，例如：
check interval=3000 rise=2 fall=3 timeout=1000 type=http; - 后端需暴露 /health 接口，在准备下线时主动返回 503 Service Unavailable；Nginx 探测到连续 3 次失败后，会立即将该节点标记为 down
- 也可手动将待下线节点的 weight=0（如 server 192.168.1.10:8080 weight=0;），再执行 nginx -s reload 热更新 upstream，无需重启服务
延长代理超时并保留长连接能力
已有请求不能被中断，Nginx 必须配合后端 draining 时间窗口：
- 设置 proxy_read_timeout 为业务最长处理时间（如 60s 或更长），确保后端有足够时间完成已接收请求
- 启用 HTTP/1.1 与 keep-alive：
proxy_http_version 1.1;
proxy_set_header Connection "keep-alive"; - 在 upstream 中配置 keepalive 32，复用连接，避免频繁重建加重后端负担
- 开启 proxy_ignore_client_abort on，防止用户中途关闭页面导致 Nginx 提前终止后端仍在处理的请求
后端需主动配合退出节奏
Nginx 是被动协调者，后端必须承担关键动作：
- 收到下线指令（如 SIGTERM）后，立即切换就绪探针状态（如 Spring Boot 的 /actuator/health 返回 503）
- 关闭新请求入口：停用 Web 容器 connector、拒绝新 TCP 连接、或暂停 Netty EventLoop 接收
- 保持已有连接可读写，等待活跃连接自然归零（可通过 stub_status 监控 Active connections）
- 确认 draining 完成后再真正退出；若使用 systemd，应配置 ExecStop 和足够长的 TimeoutStopSec
验证与可观测性建议
上线前务必验证整个流程是否闭环：
- 通过 nginx -T 检查配置是否生效，确认 check 指令出现在 upstream 中
- 访问 /status（需启用 stub_status）观察节点状态变化和活跃连接数趋势
- 模拟下线：curl 后端 /health → 观察 Nginx 日志是否停止向该节点转发 → 查看连接数是否缓慢下降至 0
- 建议接入 prometheus + nginx-module-vts 实现自动化监控与告警
