HTTP 状态码参考

五个类别，以及第一位在告诉你什么

1xx（信息性）表示请求正在处理——100 Continue、101 Switching Protocols——除库内部外很少见到。2xx（成功）表示成功：200 OK、201 Created、204 No Content。3xx（重定向）表示资源移动了，或请求需要另看一眼：301 永久移动、302 找到、304 未修改、308 永久重定向。

4xx（客户端错误）表示请求本身无法被满足：400 错误请求、401 未认证、403 禁止、404 未找到、405 方法不允许、422 无法处理的实体、429 请求过多。5xx（服务器错误）表示服务器无法完成：500 内部服务器错误、502 网关错误、503 服务不可用、504 网关超时。两类在日志里看起来相似，但对“该由谁修”意味着非常不同的东西——所以本页每个码都标出类别，而不只是编号。

搜索，以及表格如何收窄

搜索认识代码和单词。三位数字精确匹配，所以“404”只找到一行。带 x 的模式匹配该家族的所有成员，所以“40x”找到所有 40x，“4xx”找到整个类别——当你正在诊断的正是具体代码时很有用。任何其他词都会在名称、含义和“该检查什么”里做不区分大小写的普通搜索，所以“gateway”找到 502 和 504，“retry”找到 429，“captive”找到 511。

类别下拉框先收窄同一张表，搜索再进一步收紧，所以两者是配合而不是重复。如果什么都不匹配，页面会说明，并重复规则——因为在一张固定 62 个码的表上出现“无结果”，是搜索问题，而不是缺少代码。

从一次真实的响应里读状态码

在浏览器里，状态码是你最少直接看的那个数字：开发者工具的「网络」面板给每次请求列着它，和耗时、体积并排，那一行往往最快告诉你「页面没事、接口有事」还是「页面本身坏了」。文档返回 200、里面的 fetch 返回 500，说明问题在数据层，不在访客正在读的 HTML 里。

在终端里，curl -i 会把状态行和响应头一起打印出来，curl -o /dev/null -w "%{http_code}" 只打印这一个数字——当悄悄回答你的是跳转链或者登录墙而不是接口本身时，这正是你想要的。一个始终落不到最终 URL 的 301、或者只有带上 cookie 才会变成 200 的 302，都能在这一个数字里看见，却在你最终看到的页面上看不见。

两个习惯最省时间。先读类别再读代码：4xx 是你这边能修的请求，5xx 是别人要修的服务端，这个区别决定你继续调试还是直接提单。再看响应有没有带上这个代码承诺的响应头——201 与 3xx 的 Location、429 与 503 的 Retry-After、401 的 WWW-Authenticate。没有 Retry-After 的 503、没有质询的 401，说明响应和代码对「刚刚发生了什么」各说各话。