🚦HTTP 状态码

怎么用这份状态码速查

1. 直接输入拿到的状态码——404、429、502——或者输入「重定向」「鉴权」这类关键词来查。
2. 用分类标签按族浏览：1xx、2xx、3xx、4xx、5xx。
3. 看「什么时候用」来决定自己的接口该返回哪个码，需要精确措辞就点开对应的 RFC 链接。

常见问题

重定向该用 301 还是 302？

新地址是永久的就用 301：浏览器和搜索引擎会缓存它，并把权重传递过去。临时跳转（比如把未登录用户送到登录页）用 302，更推荐 307。307 和 308 还额外保证不会改变 HTTP 方法。

401 和 403 怎么选？

401 Unauthorized 是「我不知道你是谁」——凭据缺失或无效，响应里必须带 WWW-Authenticate 头。403 Forbidden 是「我知道你是谁，但你就是不能做这件事」，重新登录也没用。

为什么老是遇到 502 和 504？

这两个都来自应用前面的代理、负载均衡或 CDN。502 表示上游返回了非法响应或拒绝连接；504 表示上游在超时之前压根没回。排查时要看代理后面那层应用的日志，而不是代理本身。