这个工具是什么 HTTP 状态码速查表,收录从 100 到 511 的常用状态码,每个都写明它是什么意思、什么时候会返回,以及排错时该往哪里看。 什么时候用它 接口报错只看到一个数字,想快速判断是客户端的问题还是服务端的问题。 分不清 401 和 403、301 和 302、502 和 504 的区别。 排查线上问题时对照「常见场景」,先把范围缩小再去看日志。 写接口文档时挑一个语义合适的状态码。 有什么限制 收录的是常用码,不是全量。框架自定义的状态码(比如某些接口用 600 表示限流)不在表里。 「常见场景」是经验总结,不是标准规定。同一个码在不同系统里含义可能不同,最终以服务端日志为准。 302 与 307、301 与 308 的区别在于是否保持请求方法,实际行为还取决于客户端实现,有些老客户端处理得并不严格。 只能告诉你状态码一般意味着什么,不能替你定位到具体哪一行代码出了问题。 常见问题 Q:401 和 403 有什么区别? A:401 是「还没登录或凭证失效」,需要先认证;403 是「认得出你,但你没有权限」。看到 403 就别去查 token 过期了,方向不对。 Q:502 和 504 分别说明什么? A:502 是网关拿到了上游不合法的响应,通常上游进程挂了或者没在监听;504 是网关等上游响应超时了,上游还活着只是处理太慢。 Q:304 算是错误吗? A:不算。它表示资源没变,让浏览器直接用本地缓存,是正常的优化行为。