HTTP 状态码大全
完整、可搜索的 HTTP 状态码参考手册,涵盖 1xx–5xx 所有状态码及使用说明。免费,基于浏览器。
- 在浏览器中处理
- 工具不会把输入上传到 ZeroTool 服务器
- 免费 · 无需注册
用微信扫描以下二维码即可分享
示例、说明与常见问题 带实际输出的示例、与同类工具的差别,以及常见问题。
状态码分类
- 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。
状态码配套的响应头
| 状态码 | 响应头 | 要求 |
|---|---|---|
| 201 | Location: /api/users/456 | 指向新建的资源 |
| 401 | WWW-Authenticate: Bearer realm="api" | 必须 |
| 405 | Allow: GET, POST | 必须(§15.5.6) |
| 429、503 | Retry-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 个状态码就在页面里,搜索只在浏览器中筛选,搜索词不发送、不保存。开启统计时,搜索事件只记录工具名和动作,不包含你输入的内容。