Nginx 反向代理常见 502 排查：从日志到上游服务的完整链路 [Copy Link]

Nginx 502 Bad Gateway 是建站最常遇的报错之一。排查的关键是分清问题在哪一层：Nginx 配置、上游服务、还是两者之间的网络。

第一步：看 Nginx 错误日志

tail -f /var/log/nginx/error.log

• connect() failed (111: Connection refused)：上游服务没起来或端口不对
• upstream timed out：上游处理超时，加大 proxy_read_timeout
• no live upstreams：上游挂了，检查进程状态

第二步：直接测上游

curl -v http://127.0.0.1:端口 能通，问题就在 Nginx 配置；不通就是上游本身的问题。

第三步：常见配置坑

• proxy_pass 结尾带不带 / 会影响路径拼接
• upstream 块里 server 写 host 还是 127.0.0.1：解析走 DNS 会出玄学问题
• 库存连接数耗尽：调整 worker_connections 和 keepalive