首页/网络/协议速查/5xx 服务端错误类(500-599)
HTTP 方法与状态码91 条

5xx 服务端错误类(500-599)

表示服务器承认自己处理失败或无力完成请求;客户端(尤其是幂等请求)可在退避后重试并关注 Retry-After。

协议速查网络更新于 2026-10-12
范围500-599
含义错误在服务端或上游/网关侧
规范RFC 9110 §15.6
常见码500、501、502、503、504

5xx 是「请求本身没错但服务没做到」。排查顺序:应用日志(500)→ 上游存活与监听(502)→ 容量与过载(503)→ 超时配置(504)。同一条 5xx 在不同网关层含义可能不同,以网关错误日志为准。

网关类 5xx 对比

状态码含义常见根因
502Bad Gateway上游进程崩溃/端口未监听/协议不匹配
503Service Unavailable过载、维护、连接池满;应带 Retry-After
504Gateway Timeout上游处理超时(读超时到点)

按幂等性决定是否重试

按幂等性决定是否重试
for i in 1 2 3; do
  curl -sf -o /dev/null https://api.example.com/status && break
  sleep $((i*2))
done

数据来源与参考

  • RFC 9110 §15.6 服务端错误
  • RFC 9110 §15.6.4(503 与 Retry-After)

相关工具

​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌