HTTP 状态码速通：从 200 到 502，排障时到底看什么

打开一个网页或者调用一个接口时，最先返回的不一定是页面内容，而是一个三位数字：HTTP 状态码。很多人看到 404 就说是页面没了，看到 500 就说是服务器坏了，其实只对了一半。状态码的真正价值，是告诉你问题出在哪一层、该由谁先动手。本文按首位数字梳理一次，排障时照着查会快很多。

先看首位数字，再看具体数字

状态码的第一位代表大类：2 开头是成功，3 开头是重定向，4 开头是客户端问题，5 开头是服务端问题。这个分类比记住每一个数字更重要。排障的第一步不是搜索错误文案，而是确认大类：如果大量请求都是 5xx，先看服务端和网关；如果只是个别请求 4xx，先看请求本身是不是写错了。

2xx：成功，但不等于符合预期

200 是最常见的成功，意思是请求被正确处理。201 常用于新建资源成功，比如提交表单后创建了一条记录；204 表示成功但没有返回内容，常见于删除操作或者只需要确认的提交。需要注意的是，返回 200 只说明 HTTP 层成功，不代表业务成功。有些接口会在 200 的响应体里再放一个业务错误码，排障时要同时看响应体，不要只看状态码就下结论。

3xx：地址变了，浏览器在帮你跳转

301 是永久重定向，旧地址以后都应该换成新地址；302 是临时重定向，常见于登录后跳转。304 比较特殊，它表示浏览器本地缓存仍然有效，服务器没有重新返回内容，这通常不是故障，反而是缓存生效的表现。如果页面一直在几个地址之间来回跳转，多数是重定向规则写成了环路，这时要检查配置，而不是反复刷新。

4xx：先检查请求，再怀疑服务

400 表示请求本身有问题，比如参数缺失、格式不对或者 JSON 写错了括号。401 表示没有通过身份验证，常见原因是登录过期或者令牌没有带上；403 则表示身份通过了，但没有权限访问这个资源，两者不要混为一谈。404 表示服务器上找不到这个地址，可能是路径拼错、资源被删除，也可能是路由没有注册。429 表示请求太频繁，被限流了，这时正确做法是放慢重试，而不是立刻连续重试。

5xx：服务端或者中间环节出了问题

500 是服务端内部错误，原因可能很多，需要结合服务端日志定位，不能只靠状态码猜。502 表示网关收到了上游无效的响应，常见原因是上游服务挂了、启动中或者超时断开；503 表示服务暂时不可用，可能是正在发布、过载或者主动限流；504 则是网关等上游等得太久，超时了。区分 502 和 504 很关键：502 更像上游直接出了问题，504 更像上游太慢或者网络链路有问题。

排障时建议按这四步走

第一步，确认状态码和请求地址，把错误复现一次，排除偶发问题。第二步，看是单条请求出错还是大面积出错，前者多半是请求或者数据问题，后者多半是服务或者配置问题。第三步，结合响应头和响应体，比如看缓存、重定向目标和业务错误信息。第四步，再去查对应一层的日志：4xx 查客户端和网关日志，5xx 查服务端和上游日志。按层定位，比从头猜要省事得多。

一个速查小结

200 成功，201 新建成功，204 成功无内容；301 永久跳转，302 临时跳转，304 缓存有效；400 请求有误，401 未登录，403 无权限，404 找不到，429 太频繁；500 服务内部错误，502 网关收到无效响应，503 暂时不可用，504 网关超时。记住这个顺序，下次看到状态码，你就知道该先看请求、缓存、权限，还是服务端和网关。