零中断升级的核心是配置重载与二进制升级彻底分离：配置变更用 nginx -s reload，版本/模块/依赖变更必须严格按 usr2→winch→quit 三步完成二进制平滑升级。
版本升级时保障零中断，核心不是“优化参数”，而是**把配置重载和二进制升级彻底分开**——配置变更走 nginx -s reload，版本/模块/依赖变更必须走 USR2 + WINCH + QUIT 二进制平滑升级流程。两者混用或跳步，极易引发 worker 崩溃、连接重置或 502 抖动。
先分清：什么该 reload，什么必须升级二进制
很多中断其实源于误判：
- 只需 reload 的场景：修改 upstream 地址、调整 proxy_timeout、增删 server 块、开关 gzip、更新 SSL 证书路径等——这些纯配置项，新旧 worker 兼容性高，reload 即可无感生效；
- 必须走二进制升级的场景：Nginx 版本升级（如 1.22 → 1.24）、启用新模块（如 geoip2、brotli）、修复 OpenSSL/CPU 漏洞、更换 PCRE 或 zlib 库——这些会改变进程内存布局或系统调用行为，仅 reload 会让旧 worker 加载新模块失败，或新旧二进制混用导致 socket 处理异常。
升级前：确保新二进制与旧环境完全兼容
这是成败前提，跳过就大概率卡在 USR2 阶段：
- 执行
nginx -V，完整复制所有 configure 参数，包括--prefix、--conf-path、--with-http_ssl_module等每一个--with-xxx； - 用相同参数编译新源码：
./configure [原参数] && make，严禁 make install； - 验证新二进制：
objs/nginx -t -c /usr/local/nginx/conf/nginx.conf必须通过； - 确认是原生启动（ps 看命令行含
/usr/local/nginx/sbin/nginx），非 systemd 托管——systemd 会拦截 USR2 信号。
升级中：严格按信号顺序切换，不跳步、不颠倒
三步缺一不可，且 PID 文件名和目标进程必须精准对应：
-
USR2：向当前 master 发送
kill -USR2 $(cat /usr/local/nginx/logs/nginx.pid)，启动新 master + 新 worker；此时ps aux | grep nginx应显示两组进程； -
WINCH：向
nginx.pid.oldbin（不是 .pid）发送kill -WINCH $(cat /usr/local/nginx/logs/nginx.pid.oldbin)，仅关停旧 worker，不碰旧 master； -
QUIT：确认旧 worker 全退出后（ps 中不再出现旧 worker），再向
nginx.pid.oldbin发kill -QUIT关闭旧 master。
配置更新本身要原子化，避免 reload 时读到损坏配置
即使走对了升级流程，配置文件写法错误也会导致 reload 失败回退或半截生效：
- 不要直接编辑线上
nginx.conf；先写入临时文件，如nginx.conf.new； - 用
mv nginx.conf.new nginx.conf替换——这是原子 rename 系统调用，不可能被中断； - 每次 reload 前必跑
nginx -t，校验失败则旧配置继续运行，不会中断服务。
不复杂但容易忽略
