跳到主要内容
木圭工具箱

HTTP 状态码速查

55+ 个 HTTP 状态码分组速查，编号与关键词搜索。

本地计算 · 数据不出浏览器

按组浏览或搜索（编号前缀 / 英文短语 / 中文说明均可）。数据为 RFC 标准口径的静态表，本地检索。

1xx 信息响应4 个

100Continue已收到请求头，客户端可以继续发送请求体，通常出现在大文件上传时。
101Switching Protocols服务器同意切换协议，如从 HTTP 升级到 WebSocket。
102Processing服务器已收到请求、仍在处理中（WebDAV），防止客户端超时断开。
103Early Hints提前告诉浏览器可以预加载的资源，正式响应稍后到达。

2xx 成功响应10 个

200OK请求成功，响应体里就是你要的数据，最常见的成功状态码。
201Created请求成功并创建了新资源，常出现在 POST 建记录之后，响应头带新资源地址。
202Accepted请求已受理但还没处理完，常见于异步任务队列。
203Non-Authoritative Information返回的是代理或缓存改造过的元信息，不是源服务器的原始数据。
204No Content成功但没有响应体，常见于删除成功或保存成功且无需返回内容。
205Reset Content成功但要求客户端重置表单或视图，准备下一次输入。
206Partial Content返回的是资源的一段，出现在断点续传或视频拖动进度条时。
207Multi-Status批量操作的混合结果（WebDAV），响应体逐项列出每个资源的状态。
208Already Reported批量列出成员时该项已在上层报告过，避免重复（WebDAV）。
226IM Used服务器返回的是资源与客户端缓存的增量差异（Delta 编码）。

3xx 重定向8 个

300Multiple Choices资源有多个可选地址，客户端需要自行选择一个。
301Moved Permanently资源永久搬家了，搜索引擎会把权重转到新地址，后续请直接用新 URL。
302Found资源临时挪到了别的地址，浏览器会跳过去，原 URL 仍然有效。
303See Other请用 GET 去另一个地址取结果，常见于表单提交后防止重复提交。
304Not Modified缓存仍然有效，浏览器直接用本地副本，省流量；出现慢可能要排查缓存配置。
305Use Proxy要求通过指定代理访问资源，现代浏览器已不再支持。
307Temporary Redirect临时重定向，且保持原请求方法不变（POST 过去还是 POST）。
308Permanent Redirect永久重定向，且保持原请求方法不变，是 301 的严格版。

4xx 客户端错误29 个

400Bad Request请求本身有问题：参数格式不对、JSON 写错，服务器看不懂就拒绝。
401Unauthorized未登录或凭证无效——带上正确的 Token / 密码再试，而不是没有权限。
402Payment Required预留的「需要付费」，实践中少见，个别 API 用它表示额度用尽。
403Forbidden服务器认得你但拒绝执行——权限不足、IP 被封或目录禁止列出。
404Not Found请求的资源不存在，URL 可能写错或资源已删除。
405Method Not Allowed请求方法不对：用 GET 去打只接受 POST 的接口就会收到它，响应会列出允许的方法。
406Not Acceptable服务器给不出客户端 Accept 头要求的格式，常见于 Accept 写了不支持的类型。
407Proxy Authentication Required需要先在代理服务器上完成认证才能出网。
408Request Timeout客户端发请求太慢，服务器等不及把连接关了，重试即可。
409Conflict请求与资源当前状态冲突，典型场景是并发更新或唯一键重复。
410Gone资源已被永久删除且不再回来，比 404 更明确，应停止重试。
411Length Required服务器要求请求头里必须带 Content-Length，一般由 HTTP 客户端库补上。
412Precondition Failed请求前置条件不满足，常见于 If-Match / If-Unmodified-Since 校验失败（并发冲突）。
413Payload Too Large请求体超过了服务器允许的大小，上传大文件时最容易遇到。
414URI Too LongURL 太长了，通常是把大量参数塞进了 GET 请求，应改用 POST。
415Unsupported Media Type请求体的 Content-Type 服务器不认识，比如发 JSON 却忘了写 application/json。
416Range Not Satisfiable请求的区间超出了资源实际大小，比如对一个 1KB 文件请求 100KB 之后的内容。
417Expectation Failed请求头 Expect: 100-continue 的预期没有得到服务器满足。
418I'm a teapot彩蛋：我是茶壶，拒绝泡咖啡（RFC 2324 愚人节协议），个别站点用它反爬虫。
421Misdirected Request请求被发到了不该处理它的服务器上，常见于 HTTPS 连接复用配错域名。
422Unprocessable Entity格式没问题但语义校验不过：字段缺失、取值非法，表单/API 校验常用。
423Locked资源被锁定了（WebDAV），别人正在编辑，等锁释放再试。
424Failed Dependency依赖的上一步操作失败了，本步只能跟着失败（WebDAV 批量操作）。
425Too Early服务器拒绝处理「还可能重放」的请求，常见于 TLS Early Data（0-RTT）场景。
426Upgrade Required客户端需要升级协议（如切换到 TLS 或更高 HTTP 版本）再试。
428Precondition Required服务器要求带上 If-Match 等条件头，防止丢失更新（并发覆盖）。
429Too Many Requests请求太频繁触发了限流，稍等重试，或按 Retry-After 头指示的时间来。
431Request Header Fields Too Large请求头太大，常见于 Cookie 或 Token 塞了太多内容。
451Unavailable For Legal Reasons因法律原因不可访问（如被要求下架或地域屏蔽），编号致敬《华氏 451》。

5xx 服务端错误11 个

500Internal Server Error服务器内部出错了，去查服务端日志，客户端这边通常无能为力。
501Not Implemented服务器不支持实现这个功能，比如用了它不认识的请求方法。
502Bad Gateway网关/反向代理拿到了上游的无效响应，上游服务大概率挂了或端口不对。
503Service Unavailable服务暂时不可用：正在重启、过载维护，稍后重试或看 Retry-After。
504Gateway Timeout网关等上游响应超时了，上游处理太慢或卡死，排查后端耗时。
505HTTP Version Not Supported服务器不支持请求用的 HTTP 版本，如对老服务发 HTTP/2。
506Variant Also Negotiates服务器内容协商配置有环，透明协商机制无法得出结果。
507Insufficient Storage服务器存储空间不足（WebDAV），写不进去了。
508Loop Detected服务器在处理请求时检测到无限循环（WebDAV）。
510Not Extended请求缺少服务器要求的策略扩展，需要按提示补充。
511Network Authentication Required需要先在网络层登录认证，典型场景是公共 Wi-Fi 的强制门户页。

使用说明

这个工具解决什么问题

看日志撞见 502,文档里冒出 405,同事口中的 422 到底错在哪——状态码人人见过,能说准含义的不多。搜索引擎查一次要点开三四个页面,广告与过时内容混杂。这个工具是一张干净的速查表:五组 62 个状态码按 RFC 标准口径收录,编号、英文短语、中文说明三向搜索,输入即出。

核心能力

分组收录:1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误,五组共 62 个。三向搜索:编号、英文短语、中文说明任一关键词直接过滤。标准口径:含义按 RFC 收录,每个状态码附一句人话解释。本地检索:纯浏览器静态数据,离线也能查。

使用建议

排查接口问题先记状态码再动手:4xx 回头改请求,5xx 去查服务端;写文档、画流程图需要标注状态码时直接复制标准短语;学 HTTP 时按组过一遍,比零散搜索系统得多。遇到网关类错误(502、504)先确认是上游挂了还是超时,再决定重启还是扩容。

常见问题

301 与 302 该用哪个?

301 是永久重定向,搜索引擎会把旧地址的权重转移到新地址;302 是临时重定向,权重不转移。换域名、改永久链接用 301,活动页临时跳转用 302。口径相近的还有 307 与 308,区别在于是否保留原请求方法。

4xx 与 5xx 的责任怎么划分?

4xx 是客户端错误,请求本身有问题,典型如 404 资源不存在、401 未认证、429 请求过频;5xx 是服务端错误,请求没问题但服务器处理失败,典型如 500 内部错误、502 网关拿不到上游响应。排障先看状态码落在哪一组,方向就清楚了。

怎么快速找到想查的状态码?

支持三向搜索:输入编号 404、英文短语 not found 或中文关键词都能命中。输入即过滤,无需翻表;按 1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误分组展示,顺藤摸瓜也方便。

相关工具

Git 命令速查

60 条高频 Git 命令按场景分组，命令与中文说明双向搜索。

HTTP Header 解析

Raw 头 ↔ JSON 双向转换，请求行识别，Cookie 单列。

chmod 权限计算

rwx 复选框与八进制/符号表示三向联动，支持特殊位。

查看更多格式转换，或浏览全部工具。