HTTP 状态码

什么是 HTTP 状态码参考表？#

每个 HTTP 响应都带着一个三位数状态码，用这一个数字告诉客户端：你的请求结果如何。这几个数字不是随便编的：首位代表家族——1xx 是”等一下，我先发点信息”，2xx 是”给你，成功了”，3xx 是”去别处找”，4xx 是”你客户端错了”，5xx 是”我服务器错了”。把这五个家族记住，任何一次 HTTP 交互你都能一眼读懂——不管是浏览器请求、你跑的 curl，还是应用日志里的一条报错。

麻烦在于，实际在用的状态码有六十多个，相邻几个的区别常常很细：401 和 403、302 和 307、422 和 400。本页就是一份可搜索的全量参考——码值、IANA 标准原因短语、所属家族、一段大白话解释都有。输入数字或单词，表格立刻收窄。

怎么使用#

1. 浏览或搜索。 表格按家族（1xx 到 5xx）分组列出全部状态码。用顶部的搜索框过滤。
2. 怎么想就怎么搜。 过滤器懂得你的意图：
   • 输入数字，比如 30 或 418，按码值前缀匹配——30 直接把整个 3xx 重定向家族捞出来。
   • 输入单词，比如 redirect、timeout、teapot，就在原因短语和描述里做全文搜索，不区分大小写。
3. 看行。 每行有码值（Code）（数字）、原因（Reason）（标准短语，如 “Not Found”）、类别（Category）（本地化后的家族标签）、描述（Description）（这个码什么时候返回的一句话）。表格下方的状态栏会报”匹配到 N 行”。

主要特性#

• 全量 IANA 码 + 事实标准码。 网上真实会返回的码全收，从 100 Continue 一路到 511 Network Authentication Required，连 WebDAV 专用的 207/208/226、恶搞用的 418 I'm a Teapot、以及法律原因的 451 都在。
• 数字搜索按前缀。 输个 4 不会倒出一堆随机结果，而是按顺序给出全部 4xx 客户端错误——正是你”不记得某个家族”时的探索方式。
• 单词跨原因和描述搜索。 输 rate 找到 429 Too Many Requests；输 range 找到 416 Range Not Satisfiable；输 auth 同时捞出 401 和 407。
• 原因短语保持原样。 “Not Found”、“Gateway Timeout” 这些是技术标识符，不是译文——跟服务器真实在线发送的字符串一致，可以直接贴进文档或 issue。
• 完全在浏览器里跑。 数据集随页面一起下发，过滤在本地完成，不发任何网络请求。

实例演示#

几乎每个开发者都被客户端错误的”三连”401、403、404 绊过至少一次。搜 40，三行一次性并排出现：

• 401 Unauthorized —— “需要认证，但认证失败或未提供。“服务器不知道你是谁。解法：带上凭证（登录令牌、API key）。
• 403 Forbidden —— “请求合法，但服务器拒绝执行（权限不足）。“服务器很清楚你是谁，但你就是拿不到。解法：去申请权限，而不是再输一遍密码。
• 404 Not Found —— “请求的资源找不到。“URL 本身错了，或资源已不存在。解法：改对路径。

最实用的区分就是 401 对 403：“我不认识你”（去登录）对”我认识你，但不行”（去申请权限）。重新认证永远修不好 403，改 URL 也永远修不好 401。

第二组常用的是重定向家族。搜 30 就能看到：历史上 301、302 允许客户端在跳转后改换请求方法（一个 POST 可能被降级成 GET），而 307、308 正是为”保留原方法”而引入的——所以现代 API 在重定向表单提交时，会指向 307/308，而不是 301/302。

常见问题#

状态码的首位数字代表什么？#

代表家族。1xx 是信息性的（服务器在说”等等，后面还有”），2xx 成功，3xx 重定向（去别处找），4xx 客户端错误（你的请求有问题），5xx 服务器错误（请求没问题，但服务器自己挂了）。剩下两位才是在该家族里定位具体码值。

418 是真的状态码吗？#

它最早来自一篇愚人节 RFC，讲一只拒绝煮咖啡的茶壶，所以本来不是给生产环境用的。话虽如此，有些服务确实会用 418 来俏皮地表达”你发来的东西莫名其妙”，认得它也无害。本参考收录它，是因为你在真实环境里就是会遇到。

为什么有些码标着 WebDAV？#

像 207 Multi-Status、423 Locked、507 Insufficient Storage 这些，是为 WebDAV 定义的——WebDAV 是 HTTP 的一套扩展，用于协同编辑文件。普通 Web API 里很少见，但在暴露类文件系统接口的系统里会冒出来，所以描述里特别标注了 WebDAV 出处，方便你理解上下文。

原因短语是从哪来的？#

它们是 IANA 登记的标准英文原因短语，也就是服务器在状态行里跟在码值后面那一串（比如 HTTP/1.1 404 Not Found）。它们是技术标识符，所以原样展示、不做翻译；本页被本地化的部分是列标题、类别标签，以及这段说明文字。