HTTP 状态码速记：常见错误码的意思与排障顺序

接口报错先看状态码，能少猜一半。把最常见的几个记熟，排障顺序就出来了。

一、2xx 和 3xx：基本没坏

• 200：成功，最常见。
• 201：新建成功，POST 建资源常返回这个，别当异常。
• 301 / 302：永久 / 临时跳转，接口突然返回一串 HTML 时，先怀疑被跳转到了登录页或 http 跳 https。
• 304：缓存命中，浏览器没重新下载，不是错误。

二、4xx：先查请求这边

curl -i https://example.com/api/test   # -i 把状态行和响应头一起打出来

• 400：参数不对，看请求体格式和必填字段。
• 401：没登录或 token 过期，先换新 token 再试，别先怀疑服务器。
• 403：登录了但没权限，或被防火墙、安全组规则拦了，和 401 的区别是身份认了、就是不让过。
• 404：地址写错或资源真的不存在，先核对路径和大小写。
• 429：请求太频繁被限流，退避重试，别并发硬冲。

三、5xx：再查服务器那边

• 500：程序内部报错，直接去看应用日志，状态码本身不会告诉你哪一行错了。
• 502：网关连不上后端，先 curl 直连后端端口验证服务在不在。
• 503：服务暂时不可用，可能是刚重启、过载或在发布中，过一会儿再试。
• 504：网关等后端超时，多半是后端处理太慢或数据库查询卡住。

四、排障顺序一句话

先分段：3xx 看跳转、4xx 查请求和权限、5xx 查后端和日志。拿不准时用 curl -i 把状态码、响应头、响应体一次看完，再决定去哪边查，比对着页面刷新猜要快得多。