Web 服务器与网关 / 系统课时

定位 502 与 504 响应

定位 502 与 504 响应

本课解决 Nginx 网关返回 502、503、504 时无法快速判断原因的问题,通过日志、连接状态和上游耗时建立定位顺序,最终找到端口错误、服务不可用、协议异常或超时等具体故障点。

学习目标

  • 掌握 502、503、504 的典型触发条件和区别
  • 学会结合 Nginx 日志与上游服务状态定位故障
  • 建立从入口到上游的排障验证流程

理解 502、503、504 的差异

Nginx 作为反向代理时,需要连接上游应用并读取响应。不同阶段失败会产生不同状态码。502 通常表示网关与上游通信失败,503 表示服务暂时无法提供请求处理能力,504 表示连接建立后等待上游响应超时。

常见原因包括上游端口配置错误、应用进程退出、Unix Socket 权限异常、HTTP 协议不匹配、应用处理时间过长以及网络连接异常。

按入口到上游顺序定位

排查时不要直接修改超时时间,而应先确认请求经过哪些环节。第一步查看 Nginx 错误日志,确认失败阶段和目标 upstream;第二步检查监听端口和进程状态;第三步验证应用自身响应速度。

bash
# 查看最近的 Nginx 错误日志,定位 upstream 失败原因
sudo tail -n 50 /var/log/nginx/error.log

# 验证上游端口是否可连接
curl -I http://127.0.0.1:<PORT>/health

预期输出

text
connect() failed (111: Connection refused) while connecting to upstream
HTTP/1.1 200 OK

第一行表示 Nginx 无法建立到上游的连接,常见于端口错误或进程未启动。第二行表示上游健康检查接口可以正常响应。

分析关键日志信息

502 日志通常包含 connect() failed、upstream prematurely closed connection 等信息。前者偏向连接建立失败,后者表示上游接受请求后异常关闭连接。

504 日志通常包含 upstream timed out,此时需要关注应用执行时间、数据库查询耗时和 Nginx 超时配置,而不是简单提高超时时间。

nginx
location /api/ {
    proxy_pass http://backend;
    proxy_connect_timeout <TIME>;
    proxy_read_timeout <TIME>;
}

预期结果

text
Nginx 使用指定连接超时和读取超时等待上游响应

处理典型故障场景

如果发现 502,优先检查 upstream 地址、服务监听状态和协议类型。例如后端只提供 HTTPS,而 Nginx 使用 HTTP 转发,也可能导致协议错误。

如果发现 504,应进一步查看应用日志和接口耗时。若单次请求本身需要较长时间,应优化业务处理;若只是偶发慢请求,可以结合连接池、缓存和异步处理降低压力。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位 502 与 504 响应

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通