现象:配置改对了,请求还在走老路
情况是这样的:原来的 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 信号,它做的事情是:
- master 进程重新读取配置文件;
- 按新配置启动一批新的 worker 进程;
- 向旧的 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 看进程,
三步下来心里才有底。
这是我的第一篇技术笔记,记录真实踩过的坑。如果哪天你也遇到同样的问题,希望它帮你省下十分钟。