HTTP 状态码大全

完整、可搜索的 HTTP 状态码参考手册,涵盖 1xx–5xx 所有状态码及使用说明。免费,基于浏览器。

  • 在浏览器中处理
  • 工具不会把输入上传到 ZeroTool 服务器
  • 免费 · 无需注册
输入代码、名称或英文描述即可实时筛选;纯数字只按状态码开头匹配,不区分大小写,全角数字和字母也能匹配。清空搜索,或在工具内按 Ctrl/⌘+L,可重新显示全部代码。

状态码

列表按 1xx 到 5xx 分组,列出 IANA HTTP 状态码注册表中的全部 64 个代码。所有语言页面的名称和描述均为英文,只有个别产品使用的代码未收录。
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。

状态码分类

  • 1xx 信息性:临时响应——请求已收到,服务器仍在处理中。
  • 2xx 成功:请求已被接收、理解并处理完成。
  • 3xx 重定向:需要进一步操作才能完成请求。
  • 4xx 客户端错误:请求语法有误或无法完成。
  • 5xx 服务器错误:服务器无法处理有效请求。

常用状态码速览

  • 200 OK — 标准成功响应。
  • 201 Created — 新资源已创建(常见于 POST/PUT API)。
  • 204 No Content — 成功,无响应体(常见于 DELETE)。
  • 301 Moved Permanently — SEO 安全的永久重定向。
  • 400 Bad Request — 客户端发送了格式错误的数据。
  • 401 Unauthorized — 需要身份验证。
  • 403 Forbidden — 已验证但无权限。
  • 404 Not Found — 资源不存在。
  • 429 Too Many Requests — 超出请求频率限制。
  • 500 Internal Server Error — 服务器意外故障。
  • 503 Service Unavailable — 服务器宕机或过载。

对照微信支付 APIv3 的状态码表

微信支付商户文档的《HTTP 状态码》(更新于 2024-07-25)列了 12 个状态码和对应的处理方式。其中有几条和 RFC 中的一般含义不同,用本工具查英文原义时要留意:

  • 202:文档写「服务器已接受请求,但尚未处理」,处理方式是「请使用原参数重复请求一遍」。在工具里搜 accepted:
202 Accepted
  • 401:微信支付用它表示「签名验证失败」(错误码 SIGN_ERROR),而工具里 401 的英文说明只是 Authentication is required and has failed or not yet been provided.。排查时应先查签名串和私钥。
  • 429:文档写「请求超过频率限制」;退款场景下这并不表示明确「未受理」,文档建议先查询订单状态再决定是否重试。
  • 502 / 503:502 是「服务下线,暂时不可用」,503 是「服务不可用,过载保护」,都建议稍后重试。搜 gateway 会同时列出文档里没有的 504:
502 Bad Gateway
504 Gateway Timeout

用中文输入法时,数字可能是全角的。搜索前会先把全角数字和字母换成半角(Unicode NFKC 规范化),所以直接输入全角的 429 也能找到:

429 Too Many Requests

API 该返回哪个状态码

场景状态码
GET 返回资源200
POST 创建了资源201,并带 Location 头
成功但没有响应体(常见于 DELETE)204
请求体不是合法 JSON 或有语法错误400
没带 token 或 token 无效401
token 有效,但用户没有权限403
资源不存在404
重复数据,例如邮箱已注册409
请求体能解析,但违反业务规则(结束日期早于开始日期)422
超出频率限制429
未处理的异常500

401 还是 403。 401 表示服务器不知道你是谁,返回 401 时必须同时带 WWW-Authenticate 头(RFC 9110 §15.5.2)。403 表示服务器知道你是谁,但不允许这个操作。如果不能暴露资源是否存在,可以用 404 代替 403(§15.5.4)。

重定向与请求方法。 由于历史原因,浏览器跟随 301 或 302 时可以把 POST 改成 GET(§15.4.2);307 和 308 必须保留方法和请求体。表单 POST 需要保持为 POST 时,用 307 或 308。

状态码配套的响应头

状态码响应头要求
201Location: /api/users/456指向新建的资源
401WWW-Authenticate: Bearer realm="api"必须
405Allow: GET, POST必须(§15.5.6)
429、503Retry-After: 60可选;秒数或 HTTP 日期(RFC 6585 §4)
304—无响应体,客户端使用缓存

在 JavaScript 中处理状态码

fetch() 遇到 4xx、5xx 不会 reject,只有网络错误才会,所以要检查 res.ok(200–299 时为 true)或 res.status:

const res = await fetch('/api/orders', { method: 'POST', body });
if (res.status === 401) return redirectToLogin();
if (res.status === 429) {
  const wait = Number(res.headers.get('Retry-After') ?? 60);
  return retryAfter(wait);
}
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const order = await res.json();

限制

  • 收录 IANA 注册表中的全部 64 个状态码。 列表与 IANA HTTP 状态码注册表(最后更新 2025-09-15)逐个对应,名称也用注册表的写法:104 是临时登记,2026-11-13 到期;305 Use Proxy 已弃用;306 和 418 写作 (Unused);510 标为 OBSOLETED(已废止)。只有个别产品使用的状态码(如 nginx 的 499、Cloudflare 的 520–526)既不在注册表里,也不在列表里。
  • 旧名称仍能搜到。 RFC 9110 把 413 改名为 Content Too Large、422 改名为 Unprocessable Content;说明里保留了旧名称 Payload Too Large 和 Unprocessable Entity,搜新旧名称都能找到。418 来自愚人节 RFC 2324 的「I'm a teapot」,RFC 9110 第 15.5.19 节把它保留下来、暂不分配,说明里也写明了这一点。
  • 说明只有英文。 各语言页面上的名称和说明都是英文。只输入数字时按状态码开头匹配(20 列出 200–208),不在名称和说明里找数字;其他查询匹配名称或英文说明中的词,例如搜「重定向」没有结果,要搜英文词;而且 redirect 只能找到 307 和 308,301、302 的说明里写的是 moved。全角数字和字母会先换成半角再搜索(NFKC 规范化)。

FAQ

HTTP 状态码各范围的含义是什么?

1xx = 信息性(请求已收到,继续处理);2xx = 成功(请求已完成);3xx = 重定向(需要进一步操作);4xx = 客户端错误(请求有误、资源不存在、未授权);5xx = 服务器错误(服务器无法处理有效请求)。

301 和 302 有什么区别?

301 Moved Permanently 表示资源有了新的永久地址,以后应改用新地址(RFC 9110 第 15.4.2 节);302 Found 表示只是临时换了地址,客户端以后仍应使用原地址(第 15.4.3 节)。Google 的抓取工具把 301 当作应处理跳转目标的强信号,把 302 当作弱信号。浏览器跟随这两种跳转时都可能把 POST 改成 GET,要保留方法请用 308 和 307。

什么时候用 404,什么时候用 410?

服务器确定资源是有意删除、而且多半不会恢复时用 410 Gone;无法判断是否永久时,RFC 9110 第 15.5.11 节要求用 404。对 Google 搜索来说两者没有区别:除 429 以外的 4xx 都按同一方式处理,URL 会从索引中移除。

为什么 429 对 API 很重要?

429 Too Many Requests 是限流用的状态码(RFC 6585 第 4 节),响应里可以带 Retry-After 告诉客户端等几秒。客户端应至少等这么久,连续收到 429 时再逐步拉长间隔。Google 的抓取工具把 429 当作服务器错误,会放慢抓取。

搜索的内容会发送出去吗?

不会。64 个状态码就在页面里,搜索只在浏览器中筛选,搜索词不发送、不保存。开启统计时,搜索事件只记录工具名和动作,不包含你输入的内容。