对照表
| 状态码 | 语义 | 第一现场 | 常见动作 |
|---|---|---|---|
| 502 | 收到无效响应/连不上上游 | Nginx error.log 的 connect()/upstream 行 | 拉起后端、核对端口与协议、检查 PHP-FPM |
| 503 | 暂时不服务（过载/维护） | 限流器、维护开关、连接池指标 | 扩容、限流、带 Retry-After 的降级页 |
| 504 | 等待上游处理超时 | upstream_response_time、慢查询日志 | 优化慢点、长任务异步化、评估超时阈值 |
| 快速判定 | 看网关错误日志前缀：connect → 502；timeout → 504；no live upstreams → 503 |
|---|
Nginx 错误日志定位命令
Nginx 错误日志定位命令
tail -100 /var/log/nginx/error.log | grep -E '502|503|504' \
| sed -E 's/.*(connect\(\) failed|upstream timed out|no live upstreams).*/\1/' | sort | uniq -c