HTTP 状态码 4xx/5xx 的排查思路

HTTP 状态码 4xx/5xx 的排查思路

今天是 2026年11月4日（星期三）。这篇短文把「HTTP 状态码 4xx/5xx 的排查思路」拆成几个可以立即验证的点，尽量少讲概念，多给出可操作的判断依据。

一、先把边界划清楚

4xx 优先检查请求方法、路径、请求头、鉴权和参数校验，不要先怀疑服务器挂了。

5xx 先看应用日志和上游依赖，再看网关超时、连接池耗尽和线程阻塞。

二、常见误区

• 4xx 优先检查请求方法、路径、请求头、鉴权和参数校验，不要先怀疑服务器挂了。
• 5xx 先看应用日志和上游依赖，再看网关超时、连接池耗尽和线程阻塞。
• 同一接口偶发 502 时，对比网关访问日志与应用日志的时间戳，区分“没打到应用”和“应用返回慢”。
• 为错误响应附带可检索的 request id，能显著缩短跨服务排查时间。

三、一段可以直接试的命令

curl -i -X POST https://api.example.com/v1/items \
  -H 'Content-Type: application/json' \
  -d '{"name":"demo"}'

把上面的命令在隔离环境里跑一遍，再对照自己的服务观察输出。很多问题不是配置写错，而是没有先确认实际行为。

小结

处理这类问题的顺序建议是：先复现、再定位、最后才改配置。如果当天没有时间做完整排查，至少把复现命令和观察结果记录下来，第二天可以接着做。