Web 服务器与网关 / 系统课时
reload 为什么通常比 restart 合适
reload 为什么通常比 restart 合适
只更新站点配置时,通常希望新请求使用新规则,而正在处理的请求有机会正常结束。平滑重载通过两代 Worker 完成这种交接。本篇在独立实例中比较发布标记与 Master PID,再说明重载失败、长连接和服务管理器的边界。
学习目标
- 解释 Master 与新旧 Worker 在重载时的职责。
- 核对新配置实际生效并确认 Master 保持运行。
- 为加载失败和长期请求准备观察与回退。
重载让两代 Worker 交接
Master 接到重载后检查并尝试应用新配置;成功后启动新 Worker,通知旧 Worker 平滑退出。旧 Worker 停止接受新连接,继续处理已有客户端,完成后退出。应用新配置失败时,Master 继续使用旧配置。官方重载过程说明

用独立实例验证版本交接
沿用前章已停掉的 /tmp/nginx-worker-lab/nginx.conf;需要 Linux shell、sed、Nginx 1.28、curl 与空闲回环 8080。以下完整实验创建新的目录,不修改原配置:
set -eu
base=/tmp/nginx-reload-lab
mkdir -p "$base"
sed 's#/tmp/nginx-worker-lab#/tmp/nginx-reload-lab#g; s/worker=\$pid/version=v1/' /tmp/nginx-worker-lab/nginx.conf > "$base/nginx.conf"
nginx -p "$base/" -c nginx.conf -t
nginx -p "$base/" -c nginx.conf
master_before=$(cat "$base/nginx.pid")
curl --noproxy '*' -sS http://127.0.0.1:8080/
sed -i 's/version=v1/version=v2/' "$base/nginx.conf"
nginx -p "$base/" -c nginx.conf -t
nginx -p "$base/" -c nginx.conf -s reload
for i in $(seq 1 50); do
result=$(curl --noproxy '*' -sS http://127.0.0.1:8080/)
test "$result" = 'version=v2' && break
sleep 0.05
done
test "$result" = 'version=v2'
printf '%s\n' "$result"
test "$master_before" = "$(cat "$base/nginx.pid")"
printf 'master-same=yes\n'
nginx -p "$base/" -c nginx.conf -s quit预期输出:
version=v1
version=v2
master-same=yes配置检查与信号消息另写到终端诊断输出。等待循环有上限,避免把尚未切换的响应当作成功。命令中断时,应检查并停止这个专用实验实例,不能误操作其他 Master。
restart 的行为要核对服务定义
restart 通常包含停止再启动,可能产生监听空档或影响正在进行的连接;具体停止信号和等待策略取决于服务管理器配置。不要笼统承诺所有 restart 都立即切断,也不要把 reload 说成绝对零影响。
二进制升级、底层依赖或部署方式改变,需要独立设计升级流程,不能只套用一次普通配置重载。多个实例发布也要考虑逐台切换与健康检查。
长请求与失败情况仍要观察
WebSocket、流式连接和长下载可能使旧 Worker 保留较久。监控旧进程退出、资源峰值与连接状态,检查是否配置了 worker_shutdown_timeout;不要为追求“进程马上变少”直接杀掉仍在服务的旧 Worker。
重载命令成功发送信号不等于业务已经正确。继续查看 error log、Worker 变化和关键请求;新版本有语法上合法的逻辑错误时仍要回退。实验的版本标记只验证交接,不替代真实业务与长请求验收。