Nginx 改了配置还报 502?reload 与 restart 到底差在哪

今天把服务器上的 WordPress 换成了纯静态站点,配置文件改完、nginx -t 通过、 systemctl reload nginx 也执行成功,结果打开首页还是 502。 错误日志里那句 connect() failed (111: Connection refused) 让我一度以为配置根本没生效。

现象:配置改对了,请求还在走老路

情况是这样的:原来的 Nginx 把 80 端口反代到 127.0.0.1:8080(后面是 Docker 里的 WordPress)。 我把 WordPress 容器删掉、把站点根目录改成 /var/www/blog 并 reload, 按理说静态文件应该直接返回了。

但 curl http://127.0.0.1/ 返回的是 502,错误日志写着:

[error] 11620#11620: *712 connect() failed (111: Connection refused)
while connecting to upstream, client: 127.0.0.1,
request: "GET / HTTP/1.1",
upstream: "http://127.0.0.1:8080/"

注意最后那行 upstream: http://127.0.0.1:8080/——它还在往一个已经被我删掉的容器上转发。 可是配置里明明已经没有 proxy_pass 了。

第一步:确认新配置到底有没有生效

先别急着改配置,让 Nginx 自己告诉你它现在用的是哪一份:

nginx -T | grep -E "root |proxy_pass|server_name"

-T 会把主配置和所有 include 进来的文件全部展开打印。输出里已经能看到 root /var/www/blog;,而且没有任何 proxy_pass。 这说明配置文件本身是对的、语法检查也通过了。

那么问题就不在配置,而在"谁在处理请求"。

第二步:理解 reload 做了什么

nginx -s reload(等价于 systemctl reload nginx)发出去的是 HUP 信号,它做的事情是:

  1. master 进程重新读取配置文件;
  2. 按新配置启动一批新的 worker 进程;
  3. 向旧的 worker 进程发送 QUIT 信号,让它们"优雅退出"——处理完手上已有的请求再走。

关键在于最后那半句。旧 worker 不会立刻死掉,它要把已经建立的连接服务完。 而浏览器访问用的是 HTTP keep-alive 长连接,一个连接可能挂几十秒甚至几分钟。 在这段时间里,旧 worker 仍然用旧配置在响应请求——包括继续把请求转发给那个已经不存在的 8080 端口。

所以 reload 之后你看到的现象是:新连接走新配置,老连接走老配置, 两者同时存在。配置"生效了",但没有立刻"全部生效"。

第三步:验证这个猜测

最直接的验证方式是绕开长连接,用一次全新的请求:

curl -H "Connection: close" http://127.0.0.1/

如果这样能返回 200,而浏览器里还是 502,那就基本可以确定是旧 worker 还没退干净。 另一个办法是看进程:

ps -ef | grep nginx
# 如果能看到多个 worker,且启动时间不一致,说明新旧交替还在进行

结论:什么时候用 reload,什么时候用 restart

这不是"reload 有 bug",而是它的设计如此。选择标准其实很简单:

  • 日常改配置(加个 location、改个 header):用 reload。不断连接,用户无感。
  • 上游服务被删掉/换了、端口彻底变了:用 restart。你就是要让旧连接立刻作废。
  • 改了监听端口、worker 数量以外的核心参数:也是 restart 更稳妥。

我这次属于第二种,执行:

systemctl restart nginx

重启后 curl 立刻返回 200,耗时 42 毫秒,问题解决。

顺带记下来的两点

一是看日志要看全。错误日志里 upstream 那一行是最有价值的信息, 它直接告诉了你"请求被转发到了哪里",比盯着配置文件猜要快得多。

二是 reload 之后要验证,不要假设。执行成功不等于结果正确。 nginx -T 看配置、curl 看响应、ps 看进程, 三步下来心里才有底。


这是我的第一篇技术笔记,记录真实踩过的坑。如果哪天你也遇到同样的问题,希望它帮你省下十分钟。

← 返回技术分享 下一篇:28 倍的提速 →