HTTP 状态码

Web 工具

速查 HTTP 状态码含义与使用场景,覆盖 1xx 至 5xx 各类响应并附解决示例。完整覆盖 1xx 至 5xx,并给出每个状态码的典型触发场景与排查方向。特别区分 301 与 302、401 与 403、502 与 504 等易混组合。每条都附常见触发原因与排查建议。按 1xx 到 5xx 分类便于检索。

80 个状态码
100信息
继续
请求带 Expect: 100-continue 时给的中间响应,客户端收到后才发请求体。若服务端不接受这些头可以直接回 417,省掉整个上传。
RFC 9110 §15.2.1
101信息
切换协议
服务端接受 Upgrade 请求并切换到指定协议(最常见是 websocket)。此后这条连接不再说 HTTP。
RFC 9110 §15.2.2
102信息
处理中
WebDAV 用:服务端已收完整个请求、仍在处理,用来防止客户端在长操作上超时。
RFC 2518
103信息
早期提示
允许服务端在最终响应前先发 Link 头,让浏览器在源站还在渲染时就预加载 CSS/JS。
RFC 8297
104临时注册信息
支持断点续传上传
临时注册,2026-11-13 到期。表示中断的上传可以从偏移量续传,不必重传整个文件。
draft-ietf-httpbis-resumable-upload-05
200成功
成功
默认的成功响应。具体含义随方法变化:GET 是返回了资源,PUT 是替换成功,POST 是返回了处理结果。
RFC 9110 §15.3.1
201成功
已创建
新资源已创建。Location 头必须指向它——API 返回 201 却漏了 Location,客户端就找不到自己刚创建的东西。
RFC 9110 §15.3.2
202成功
已接受
已入队待处理,活儿还没干。要给客户端一个句柄(任务 id 或状态 URL)让它能轮询。
RFC 9110 §15.3.3
203成功
非权威信息
内容来自会改写正文的代理而非源站,比如做 HTML 重写的 CDN。除非你自己运营这类代理,否则很少是正确选择。
RFC 9110 §15.3.4
204成功
无内容
成功且刻意不带正文,DELETE 或靠自己跳转的表单 POST 常用。不要同时给正文,有的客户端会因为两者矛盾而出错。
RFC 9110 §15.3.5
205成功
重置内容
让客户端清空刚提交的表单。现代浏览器基本忽略它,还是自己在页面上重置吧。
RFC 9110 §15.3.6
206成功
部分内容
对 Range 请求的回答。Content-Range 头说明返回的是哪一段字节;漏了它,视频播放器和断点续传都会坏。
RFC 9110 §15.3.7
207成功
多状态
WebDAV 用:一次请求涉及多个资源,XML 正文里为每个资源分别给状态。
RFC 4918
208成功
已报告
WebDAV 用:该资源在本次 207 响应里已列过,这里跳过以免深层目录遍历出现重复。
RFC 5842
226成功
增量更新
正文是一组增量补丁而非完整记录。只在带 A-IM 头时出现,主流服务端几乎都没实现。
RFC 3229
300重定向
多重选择
存在多种表示形式、服务端不替你选。实际上客户端基本不知道该怎么办,不如用 302 并给出明确目标。
RFC 9110 §15.4.1
301重定向
永久移动
永久移动,浏览器和 CDN 会长期缓存。只有确定旧地址永不再用才发——误发 301 很难撤销,因为缓存会一直照着跳。
RFC 9110 §15.4.2
302重定向
临时移动
临时跳转,不缓存。历史坑在于大多数客户端会把 POST 改成 GET,这也是 307 存在的原因。
RFC 9110 §15.4.3
303重定向
查看其他位置
明确表示「用 GET 去那个地址取结果」,POST 成功后想做跳转而不是返回 201 时,这才是指定动作。
RFC 9110 §15.4.4
304重定向
未修改
条件 GET 命中:客户端缓存仍有效,不要带正文。必须同时给 ETag 或 Last-Modified,否则下次请求没有可再验证的依据。
RFC 9110 §15.4.5
305重定向
使用代理
因安全问题已弃用,RFC 9110 明确要求客户端不得遵循。仅作完整收录。
RFC 9110 §15.4.6
306保留未用重定向
(未使用)
保留但从未分配。早期草案里曾是「切换代理」,此后这个号码一直空着。
RFC 9110 §15.4.7
307重定向
临时重定向
类似 302,但必须保持方法和正文不变,POST 仍是 POST。表单或 API 端点的临时迁移用它。
RFC 9110 §15.4.8
308重定向
永久重定向
类似 301,但保持方法不变。迁移 API 基址时更安全,客户端不会把 POST 悄悄降级成 GET。
RFC 9110 §15.4.9
400客户端错误
请求错误
请求本身有问题——JSON 坏了、缺必填字段、类型不对。正文里说明哪里错,光回一个 400 等于让调用方猜。
RFC 9110 §15.5.1
401客户端错误
未认证
没带凭据或凭据无效。名字有误导:它的意思是「未认证」而不是「无权限」,后者是 403。必须带 WWW-Authenticate 头。
RFC 9110 §15.5.2
402客户端错误
需要付费
长期保留给未来使用,HTTP 层面至今没有正式定义,但不少 API 拿它表示额度用尽。这么用就写进文档。
RFC 9110 §15.5.3
403客户端错误
禁止访问
凭据没问题,但这个身份不许做这件事。重新登录没有用,这就是它与 401 的区别。
RFC 9110 §15.5.4
404客户端错误
未找到
该地址没有资源,且刻意不透露它是否曾经存在。用 404 掩盖「存在但不属于你」是防止枚举 ID 的常见做法。
RFC 9110 §15.5.5
405客户端错误
方法不允许
地址存在,但不支持这个方法。必须回 Allow 头列出可用方法——这正是选 405 而不是 404 的意义。
RFC 9110 §15.5.6
406客户端错误
不可接受
内容协商失败:服务端能产出的格式都不符合 Accept 头。常见于 API 只输出 JSON 而客户端要 XML。
RFC 9110 §15.5.7
407客户端错误
需要代理认证
前面的代理要凭据,不是源站要。挑战走 Proxy-Authenticate 头,与 WWW-Authenticate 是两套。
RFC 9110 §15.5.8
408客户端错误
请求超时
服务端等请求等不下去了。空闲的 keep-alive 连接上出现属正常;上传到一半出现则说明客户端卡住了。
RFC 9110 §15.5.9
409客户端错误
冲突
请求与当前状态冲突:唯一键重复、乐观锁版本不匹配、编辑冲突。通常是重新读取状态后可以重试的。
RFC 9110 §15.5.10
410客户端错误
已删除
曾经存在、永久移除,应该从索引里删掉。搜索引擎对 410 的清除比对 404 更快。
RFC 9110 §15.5.11
411客户端错误
需要长度
服务端不接受分块或未知长度的正文,要求给 Content-Length。多见于老旧代理。
RFC 9110 §15.5.12
412客户端错误
前置条件失败
If-Match 或 If-Unmodified-Since 不成立,说明资源被别人改过。这就是防止更新丢失的实现方式。
RFC 9110 §15.5.13
413客户端错误
内容过大
正文超过服务端上限。RFC 9110 已弃用旧名「Request Entity Too Large」;解决办法是调上限或改流式上传。
RFC 9110 §15.5.14
414客户端错误
URI 过长
URL 超长。几乎都是把本该放 POST 正文的数据塞进了 GET。
RFC 9110 §15.5.15
415客户端错误
不支持的媒体类型
Content-Type 不是该端点接受的类型,典型是 POST 漏了 Content-Type: application/json。先查头,别查正文。
RFC 9110 §15.5.16
416客户端错误
范围不可满足
请求的字节范围超出资源长度。回 Content-Range: bytes */<size> 让客户端能自行纠正。
RFC 9110 §15.5.17
417客户端错误
期望失败
Expect 头要求了服务端做不到的事。对不可接受的 Expect: 100-continue 就该回这个。
RFC 9110 §15.5.18
418保留未用客户端错误
(未使用)
IANA 把 418 标为未使用,RFC 9110 只保留号码、未定义行为。著名的茶壶梗出自愚人节 RFC 2324。自己写着玩可以,但没有任何标准实现会对它作出反应。
RFC 9110 §15.5.19
421客户端错误
请求指向错误
连接被复用到未授权的域名上,比如给 a.com 的 TLS 会话收到了 b.com 的请求。客户端应换一条新连接重试。
RFC 9110 §15.5.20
422客户端错误
内容无法处理
语法合法但取值在语义上不对,比如日期字段填了「昨天」。RFC 9110 已把旧名「Unprocessable Entity」改掉,但两个名字现在都还在用。
RFC 9110 §15.5.21
423客户端错误
已锁定
WebDAV 用:资源被其他主体锁定,锁释放前拒绝修改。
RFC 4918
424客户端错误
依赖失败
WebDAV 用:它依赖的另一个操作失败了,所以本次也失败。避免报出误导性的成功。
RFC 4918
425客户端错误
过早
为防重放攻击,拒绝在 TLS 握手完成前提前发送的请求。客户端应等握手结束后重发。
RFC 8470
426客户端错误
需要升级
客户端必须先切换协议(通常是升到 TLS)才能继续。用 Upgrade 头说明要求什么。
RFC 9110 §15.5.22
428客户端错误
需要前置条件
源站拒绝无条件写入以阻止更新丢失,客户端必须带 If-Match。条件不成立时配合返回 412。
RFC 6585
429客户端错误
请求过多
被限流。看 Retry-After 头,它给出该等多少秒;提前重试只会让限流窗口继续延长。
RFC 6585
431客户端错误
请求头过大
请求头总大小超限,常见原因是 Cookie 过大或把 JWT 塞进了头里。该做的是收窄 Cookie 作用域,而不是调大限制。
RFC 6585
451客户端错误
因法律原因不可用
因法律要求而屏蔽,不是运营方的选择。响应里应给出该要求或政策页面的链接,让屏蔽可被追溯。
RFC 7725
500服务端错误
服务器内部错误
服务端出错且没有更贴切的码可用。记下关联 id 并写进正文——没有它,排查时根本找不到这次请求。
RFC 9110 §15.6.1
501服务端错误
未实现
服务端根本不认识这个方法。区别于 405:那里认识方法,只是该地址不支持。
RFC 9110 §15.6.2
502服务端错误
网关错误
代理或网关从上游拿到不可用的回应——连接被拒,或响应无法解析。问题在上游,不在代理本身。
RFC 9110 §15.6.3
503服务端错误
服务不可用
过载或维护中。与 500 不同,这是预期会恢复的,所以要给 Retry-After,客户端才会退避而不是继续猛打。
RFC 9110 §15.6.4
504服务端错误
网关超时
上游没在时限内回应。几乎都是源站太慢或代理超时设得太短,先查这两个,别先改客户端。
RFC 9110 §15.6.5
505服务端错误
HTTP 版本不支持
服务端不支持该 HTTP 版本。常见于客户端用 h2c(明文 HTTP/2)连只接受 HTTP/1.1 的服务端。
RFC 9110 §15.6.6
506服务端错误
变体也需协商
透明内容协商配置错了:协商出的变体又指向另一次协商,形成循环。属于服务端配置问题。
RFC 2295
507服务端错误
存储空间不足
WebDAV 用:服务端存不下这份内容,磁盘或配额满了。相当于 WebDAV 里的 ENOSPC。
RFC 4918
508服务端错误
检测到循环
WebDAV 用:处理深度遍历时陷入无限循环,通常是因为某个集合包含了自己。
RFC 5842
510已废弃服务端错误
未扩展
随它所属的 HTTP 扩展框架一起被废弃。新代码里不要实现。
RFC 2774 (Deprecated)
511服务端错误
需要网络认证
你被强制门户拦住了:酒店或机场 Wi-Fi 要求先登录才放行流量。
RFC 6585
419framework客户端错误
页面已过期
Laravel 用它表示 CSRF token 校验失败,行为等同 403。不是 IANA 注册码,只在 Laravel 应用里出现。
Laravel
444nginx客户端错误
不返回响应
nginx 直接关闭连接、不返回任何内容,用来静默丢弃恶意或滥用请求。
nginx
449ms客户端错误
带信息重试
IIS 要求客户端补充信息后重试。微软私有,从未标准化。
Microsoft IIS
494nginx客户端错误
请求头过大
nginx 在请求到达应用之前就拒掉了超大的头,改的地方是 nginx 配置,不是应用代码。
nginx
495nginx客户端错误
客户端证书错误
nginx 收到无法验证的客户端证书。只有启用了双向 TLS 才会出现。
nginx
496nginx客户端错误
需要客户端证书
nginx 要求客户端证书但没有收到,通常是浏览器证书缺失或作用域不对。
nginx
497nginx客户端错误
明文请求发到了 HTTPS 端口
明文 HTTP 发到了 TLS 端口。几乎都是客户端协议配错,不是证书问题。
nginx
499nginx客户端错误
客户端提前断开
nginx 还没回完客户端就断开了。日志里出现通常说明上游太慢,用户等不下去走了。
nginx
509other服务端错误
超出带宽限制
共享主机的约定用法,表示月度流量配额用完。不属于 HTTP 标准。
cPanel / Apache
520cloudflare服务端错误
未知错误
Cloudflare 从源站拿到空响应或无法识别的响应。要查的是源站日志,不是 Cloudflare。
Cloudflare
521cloudflare服务端错误
源站已下线
Cloudflare 完全连不上源站:连接被拒,或进程根本没在跑。
Cloudflare
522cloudflare服务端错误
连接源站超时
与源站的 TCP 握手没完成。常见原因是防火墙静默丢包,而不是明确拒绝。
Cloudflare
523cloudflare服务端错误
源站不可达
到源站根本没有路由,通常是源站侧的 DNS 或网络配置错误。
Cloudflare
524cloudflare服务端错误
源站响应超时
连接成功了,但源站没在时限内回完。这是后端太慢的情形,与 522 不同。
Cloudflare
525cloudflare服务端错误
SSL 握手失败
与源站的 TLS 握手失败,通常是源站的加密套件或协议版本不匹配。
Cloudflare
526cloudflare服务端错误
源站证书无效
Cloudflare 无法验证源站证书:过期、自签,或域名不匹配。
Cloudflare
IANA HTTP Status Code Registry · 80 个状态码 · 2026-10-27其中 16 个不是 IANA 注册码,而是具体服务端的实现:nginx / Cloudflare / IIS / Laravel / cPanel

关于 HTTP 状态码

HTTP 状态码是服务器对每个请求给出的三位数字结果,按首位分为五类:1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误。本工具内置完整的状态码字典,输入 404、301、429 等代码即可查到标准名称、含义、所属类别及常见使用场景,也支持按关键词搜索(如"重定向""未授权")。查询随页面加载即可使用,不必安装客户端,它适合在排查接口返回、调试重定向链条或向同事解释 4xx/5xx 含义时快速查码。排查接口问题时先看状态码所属类别,能迅速判断该改客户端请求还是去查服务端日志。重定向链条尤其适合逐跳核对,配合浏览器开发者工具的网络面板,可以定位是哪一跳把请求带偏或造成了多余的往返,减少无谓的猜测。

状态码的第一位决定了响应的大类,理解这层分类比记住具体数字更实用。信息类表示请求已收到但尚未完成,成功类表示请求被正确处理,重定向类要求客户端再发起一次请求到别处,客户端错误表示请求本身有问题,服务端错误表示请求没问题但服务端处理失败。因此看到不熟悉的码,先看第一位就能判断该由谁去修。

把错误放在成功码里返回是最常见的误用,会破坏所有依赖状态码的上游逻辑。部分接口在业务失败时仍返回成功码,再在响应体里放一个错误标记,这会让监控、缓存与重试策略全部失效,因为它们只看状态码。因此正确的做法是用与语义一致的状态码表达结果,把细节放在响应体里。

临时与永久跳转的选择会影响客户端与搜索引擎的行为,混淆会带来长期问题。永久跳转会被浏览器与搜索引擎长期缓存,一旦配置错误,即使后来改回正确地址,客户端仍可能继续访问旧目标;而临时跳转不产生这种缓存。因此在本意是临时调整时应当使用临时跳转,避免留下难以撤销的缓存。

网关相关的错误码能快速区分故障位置,这在排查线上问题时很有价值。这类码通常在请求经过了网关但上游未能及时响应或响应异常时出现,因此看到它就说明问题出在网关之后而不是客户端;反之,客户端错误码说明请求根本没有到达业务逻辑。理解这一点能把排查范围立刻缩小一半。

缓存相关的码在语义上有严格区别,误用会造成用户看到过期内容。有的码要求客户端在后续请求中带上条件重新验证,有的只是表示内容未改变而无需重传,还有的用于明确指示资源已永久移除。因此在配置缓存与资源下线时应当按语义选择,而不是统一用同一个码应付。

最后,状态码与响应体的结构应当保持一致,这样客户端才能用统一逻辑处理。若一部分接口在错误时返回结构化字段,另一部分返回纯文本,客户端就需要针对每个接口单独写解析,容易遗漏。因此约定一份统一的错误结构并与状态码配套使用,是接口设计里成本很低但收益明显的规范。

实现原理

状态码按首位分五类,含义是「请求处理到了哪一步」:信息、成功、重定向、客户端错误、服务端错误。最重要的区分是传输层与业务层——把业务失败返回成功状态码会让客户端只能解析响应体判断,也让监控失去可靠信号。此外永久与临时重定向不可混用,前者会被长期缓存。

输入资源不存在时返回 200 并在响应体写 {ok:false}
输出监控看不到错误率、缓存可能缓存「失败」、客户端必须解析响应体——应返回 404

本页实测数据

收录条目80 条 = IANA 注册 64 + 厂商扩展 16
名称一致性64 条 IANA 条目与 2026-10-27 注册表逐条一致;其中 422 官方已由 Unprocessable Entity 改名为 Unprocessable Content
特殊登记状态保留未用 2 条(306、418)· 已废弃 1 条(510)· 临时注册 1 条(104)
厂商扩展构成nginx 6 条 / Cloudflare 7 条 / IIS 1 条 / Laravel 1 条 / cPanel 1 条

418 在 IANA 注册表里的官方名称是 (Unused):RFC 9110 §15.5.19 只保留了号码、没有定义任何行为,茶壶梗出自愚人节 RFC 2324,从未成为正式注册项。另有 104(断点续传上传)是临时注册,2026-11-13 到期,届时会退回未分配段。

测量方式: 以 IANA 官方 HTTP 状态码注册表(http-status-codes-1.csv,2026-10-27 抓取)为基准,把本站每条的名称与官方现行名称逐条比对;16 个非 IANA 码逐条对 nginx / Cloudflare / Microsoft / Laravel 官方文档核实。核对脚本 scripts/audit/evidence/http_status_source.py 可复跑,它同时会报出漏收、来源不明与名称过时三类问题。 · 实测于 2026-10-27

使用方法

  1. 打开「HTTP 状态码」
  2. 输入状态码或关键词筛选
  3. 查看含义、常见原因与处理建议
  4. 用「仅厂商」过滤区分非标准与厂商自定义码
  5. 按 2xx、3xx、4xx、5xx 分类核对处理策略

使用场景

  • 调试 API 返回 — 收到 422、409 时快速确认语义,判断是客户端数据问题还是冲突。
  • 配置重定向 — 区分 301 永久与 302 临时重定向,避免误用影响 SEO 权重转移。
  • 限流设计 — 为接口选择 429 Too Many Requests 并搭配 Retry-After 头。
  • 编写错误处理 — 在前端按 4xx/5xx 分类决定是否重试或提示用户。
  • 面试与学习 — 系统记忆各状态码的标准定义与适用边界。

常见问题

301 和 308 有什么区别?

两者都是永久重定向,但 301 在重定向时浏览器可能把 POST 改为 GET,而 308 严格保留原始请求方法和请求体,涉及表单提交时应优先用 308。

401 和 403 怎么区分?

401 Unauthorized 表示未认证(缺少或无效凭证,应去登录);403 Forbidden 表示已认证但无权限,再提供凭证也没用。措辞虽叫 Unauthorized,实指未认证。

什么时候该返回 404 而不是 200?

资源不存在应返回 404,让搜索引擎和客户端正确处理。用 200 返回"未找到"页面会造成软 404,影响收录并误导调用方。

418 状态码是真的吗?

418 I'm a teapot 源自愚人节 RFC 2324 的玩笑,并非正式标准,但很多框架保留了它;生产环境不应依赖它表达业务语义。

502、503、504 分别意味着什么?

502 是网关从上游收到无效响应,503 是服务暂时不可用(常见于过载或维护),504 是网关等待上游超时,排查时应分别检查上游服务与超时配置。

接口返回 200 但业务上其实失败了,这是不是错误的状态码用法?

是的,这属于把传输层成功与业务层结果混为一谈。资源不存在应返回 404,参数不合法应返回 400 或 422,未认证与无权限分别对应 401 与 403。全都返回 200 会让客户端无法通过状态码分流,只能解析响应体判断,也让监控与告警失去可靠信号,长期看会显著抬高维护成本。

302 与 301 选错了会有什么后果?

301 表示永久移动,浏览器与中间层会长期缓存这个跳转,之后即便改回原地址也可能仍被带走;302 表示临时移动,不会被长期缓存。把临时跳转写成 301 是常见的运维事故,尤其在灰度切换与域名迁移期间。短时间内可能调整的跳转一律用临时状态码,确定永久后再改为永久。

301 和 302 在 SEO 上到底有什么区别?

301 告诉搜索引擎「永久搬家」,权重会传递到新地址;302 表示「临时借道」,搜索引擎会继续索引旧地址。把永久跳转错写成 302 是常见失误,会导致新页面迟迟不被收录、旧页面一直占着排名。