登录

Nginx reload 后旧 worker 还在,未必是配置没生效

212
  • 嘴哥
    UID 590楼主

    看到新旧两批 nginx worker 同时存在,很容易以为 reload 卡住了。其实成功重载时,master 会启动使用新配置的 worker,再让旧 worker 优雅退出。旧进程停止监听新连接,但会继续处理已有客户端,处理完才退出。

    所以 “旧 PID 还在” 和“新配置未生效”不是同一个判断。长时间不结束的连接,也会影响旧 worker 的退出时间。

    另一个容易漏看的点:新配置语法没问题,不代表应用新配置一定成功。打开日志文件、建立新的监听 socket 等步骤仍可能失败;官方文档说明,这种情况会回退并继续用旧配置工作。

    检查时应同时看 error log、新 worker 是否出现,以及新建连接的实际行为。只盯着进程数量,证据不够;为了让进程列表好看就直接 restart,也可能打断本来还在服务的连接。

    你们的发布流程会验证 reload 后的新请求结果,还是只检查命令退出码?

    参考:Nginx 官方重载流程

  • 收藏支持反对

2 条回复

  • mozi
    UID 809
    #1

    「旧 worker 还在」我更先看两件事:新 worker 起没起来,以及新进来的请求表现变没变。这两个都对,旧 PID 挂着只是在收尾;有一个不对,才该翻 error log,看是不是打开日志、绑定端口失败后已经回退到旧配置。

    旧进程迟迟不退,常见不是 reload 卡死,而是 WebSocket、没关掉的 upstream 长连接或被忘掉的 keepalive 把 worker 钉住了。这时候为了让进程列表好看去 restart,等于把这些还没结束的连接一起砍掉。更合适的是给 worker_shutdown_timeout 设一个上限,让它优雅退出等到点必须退。

    发布流水线如果只看 nginx -s reload 的退出码,基本上测不到这种回退。nginx -t 也只能保证语法,保不了打开文件和监听 socket。我会在新配置里放一个只在这次发布出现的标志,比如某个响应头或探活路径,用新请求打到这个标志,才算 reload 真正成功。

  • Lvan
    UID 1112
    #2

    再补一个:旧 worker 迟迟不退的时候可以设 worker_shutdown_timeout,给它一个强制退出的期限,不然一条挂住的长连接能把旧 worker 钉到天荒地老。另外 reload 之前先 nginx -t 验语法,语法过了再 reload,少走 “回退到旧配置还不知道” 那一步。

发表回复