| 范围 | 500-599 |
|---|---|
| 含义 | 错误在服务端或上游/网关侧 |
| 规范 | RFC 9110 §15.6 |
| 常见码 | 500、501、502、503、504 |
5xx 是「请求本身没错但服务没做到」。排查顺序:应用日志(500)→ 上游存活与监听(502)→ 容量与过载(503)→ 超时配置(504)。同一条 5xx 在不同网关层含义可能不同,以网关错误日志为准。
网关类 5xx 对比
| 状态码 | 含义 | 常见根因 |
|---|---|---|
| 502 | Bad Gateway | 上游进程崩溃/端口未监听/协议不匹配 |
| 503 | Service Unavailable | 过载、维护、连接池满;应带 Retry-After |
| 504 | Gateway Timeout | 上游处理超时(读超时到点) |
按幂等性决定是否重试
按幂等性决定是否重试
for i in 1 2 3; do
curl -sf -o /dev/null https://api.example.com/status && break
sleep $((i*2))
done