HTTP 状态码速查

全部 IANA 状态码的含义与处理建议——按数字、名称或症状搜索。

显示 64 / 64 个状态码

状态码

1xx信息5

100Continue继续

服务器已收到请求头,客户端可以继续发送请求体。

怎么办继续发送请求体;如果请求已经发送完毕,可以忽略这个响应。

101Switching Protocols切换协议

服务器接受了 Upgrade 请求,正在切换到另一种协议。

怎么办之后按 Upgrade 响应头里指定的协议通信。

102Processing处理中

WebDAV已废弃

WebDAV 服务器已接受请求,但还没有处理完成。

怎么办保持连接,等待最终响应。

103Early Hints早期提示

服务器在最终响应前先发 Link 头,让客户端可以提前预加载或预连接。

怎么办现在开始预加载或预连接,同时继续等待最终状态码。

104Upload Resumption Supported支持断点续传

草案

表示中断的上传可以继续;这仍是 Internet-Draft,尚未成为正式 RFC。

怎么办按服务器给出的偏移量续传,并预期协议行为仍可能变化。

2xx成功10

200OK成功

请求成功;具体含义取决于所用的 HTTP 方法。

怎么办按方法读取响应体或响应头。

201Created已创建

请求成功,并且新建了一个资源。

怎么办用响应里的 Location 头找到新资源。

202Accepted已接受

请求已被接受处理,但还没有完成。

怎么办轮询状态接口;不要假设任务已经完成。

203Non-Authoritative Information非权威信息

返回的元数据来自副本,而不是直接来自源服务器。

怎么办把它当作代理或本地变体;需要准确信息时回源核对。

204No Content无内容

请求成功,但没有响应体需要返回。

怎么办根据状态码和响应头更新界面,不要等待响应体。

205Reset Content重置内容

客户端应重置发起该请求的文档或表单。

怎么办清空触发请求的表单或视图。

206Partial Content部分内容

服务器返回了资源中请求的那一段字节范围。

怎么办把字节追加到缓冲区;需要时继续请求下一段。

207Multi-Status多状态

WebDAV

WebDAV 响应里包含多个资源各自的状态。

怎么办解析 XML 响应体,分别处理每个资源的状态。

208Already Reported已报告

WebDAV

同一个绑定里的成员已经列过,因此不再重复。

怎么办跳过重复成员,处理之前那次响应即可。

226IM Used已使用实例操作

响应是对当前表示应用增量操作后的结果(HTTP 增量编码)。

怎么办把实例操作应用到本地缓存副本上。

3xx重定向9

300Multiple Choices多种选择

同一个资源有多个可选表示,客户端需要选择一个。

怎么办从响应里选一个表示,或使用协商好的默认表示。

301Moved Permanently永久移动

资源已永久移动,之后的请求应使用新 URL。

怎么办把书签、链接和站点地图更新为 Location 指向的 URL。

302Found临时移动

资源暂时可以从另一个 URL 访问。

怎么办本次请求跟随 Location,但之后仍使用原 URL。

303See Other查看其他位置

客户端应该用 GET 去另一个资源读取这次请求的结果。

怎么办用 GET 跟随 Location 读取结果。

304Not Modified未修改

缓存

缓存副本仍然有效,因此不需要返回响应体。

怎么办直接使用缓存响应;这个响应本身没有响应体。

305Use Proxy使用代理

已废弃

客户端被告知要通过代理访问资源;该状态码已废弃。

怎么办不要使用它,直接配置代理即可。

306Unused未使用

保留

早期规范保留的码值,现在已没有定义。

怎么办忽略它;不存在标准行为。

307Temporary Redirect临时重定向

资源暂时在别处,并且请求方法不能改变。

怎么办用相同的方法和请求体向 Location 重新发起请求。

308Permanent Redirect永久重定向

资源已永久移动,并且请求方法不能改变。

怎么办更新链接,并用相同方法向 Location 重新发起请求。

4xx客户端错误29

400Bad Request错误请求

服务器无法处理请求,因为客户端发来的内容不合法。

怎么办检查 URL、请求头和请求体语法;修正后再重试。

401Unauthorized未授权

认证

需要身份认证,或者提供的凭证被拒绝了。

怎么办发送有效凭证;检查 WWW-Authenticate 响应头。

402Payment Required需要付款

预留给需要付费的服务使用,实际很少出现。

怎么办检查该 API 的计费/支付流程;没有标准响应体。

403Forbidden禁止访问

认证

服务器理解了请求,但拒绝授权。

怎么办换用有权限的账号或令牌;不要盲目重试。

404Not Found未找到

服务器找不到请求的资源:可能是 URL 写错、路由未注册,或资源已被删除。

怎么办核对 URL 与路由,并确认资源是否已被删除,再决定是否重试。

405Method Not Allowed方法不允许

这个资源不支持请求所用的 HTTP 方法。

怎么办改用 Allow 响应头里列出的方法。

406Not Acceptable不可接受

没有任何表示能匹配请求里的 Accept 条件。

怎么办放宽 Accept 头,或改用服务器支持的格式。

407Proxy Authentication Required需要代理认证

认证

客户端与服务器之间的代理要求先认证。

怎么办配置代理凭证;检查 Proxy-Authenticate 响应头。

408Request Timeout请求超时

服务器没有在时限内收到完整请求。

怎么办换更快的网络重试,或把超时时间调长。

409Conflict冲突

请求与资源当前状态发生冲突。

怎么办先获取最新状态并解决冲突,再重试。

410Gone已删除

资源已被永久删除,而且没有转发地址。

怎么办移除链接和缓存,不要重试。

411Length Required需要长度

服务器要求 Content-Length 响应头,但请求没有提供。

怎么办补上 Content-Length,或改用分块传输编码。

412Precondition Failed前置条件失败

If-Match、If-Unmodified-Since 等条件头没有满足。

怎么办获取当前版本,用新的校验值重试。

413Content Too Large内容过大

请求体超过了服务器允许的大小。

怎么办减少数据、压缩后再发,或改用分块上传。

414URI Too LongURI 过长

请求的 URL 超过了服务器能接受的长度。

怎么办缩短查询串,或把数据放进请求体。

415Unsupported Media Type不支持的媒体类型

服务器不支持请求体的媒体类型。

怎么办改用受支持的 Content-Type;查阅 API 文档。

416Range Not Satisfiable范围无法满足

请求的字节范围无法在这个资源上满足。

怎么办检查资源大小,重新请求合法的 Range。

417Expectation Failed期望失败

服务器无法满足 Expect 请求头里的期望。

怎么办去掉或修改 Expect 头后重试。

418I'm a Teapot我是茶壶

保留

来自 RFC 2324 的愚人节状态码;RFC 9110 已把 418 注册为未使用。

怎么办不要依赖它;不存在标准行为。

421Misdirected Request请求方向错误

服务器无法为这个 scheme 与 authority 组合生成响应。

怎么办换一条能服务该源的连接重试。

422Unprocessable Content无法处理的实体

WebDAV

请求语法合法,但语义上无法处理。

怎么办修正校验错误;查看响应体里的详细错误。

423Locked已锁定

WebDAV

WebDAV 资源被另一个请求锁定了。

怎么办释放锁,或带上锁令牌再请求。

424Failed Dependency依赖失败

WebDAV

这次请求依赖的先前请求失败了。

怎么办先修复先前的操作,再重试这一批请求。

425Too Early过早

请求可能被重放,服务器拒绝处理;常见于 TLS 早期数据。

怎么办稍后重试,或不要使用早期数据重新发送。

426Upgrade Required需要升级

服务器要求换用另一种协议才能处理请求。

怎么办按 Upgrade 头指定的协议重试。

428Precondition Required需要前置条件

服务器要求请求带条件,以避免丢失更新。

怎么办在请求里带上 If-Match 或 If-Unmodified-Since。

429Too Many Requests请求过多

这个客户端的请求频率超过了限流阈值。

怎么办退避等待,并按 Retry-After 的时长再试。

431Request Header Fields Too Large请求头字段过大

请求头字段的大小超过了服务器限制。

怎么办减少 Cookie 或请求头大小后重试。

451Unavailable For Legal Reasons因法律原因不可用

服务器因法律原因拒绝提供该资源。

怎么办联系站点运营方;这是有意拦截。

5xx服务端错误11

500Internal Server Error服务器内部错误

服务器遇到意外情况,无法完成请求。

怎么办查看服务器日志;只有瞬时错误才值得重试。

501Not Implemented未实现

服务器不支持请求所要求的 HTTP 方法。

怎么办改用受支持的方法;服务器至少要支持 GET 和 HEAD。

502Bad Gateway网关错误

网关或代理从上游服务器收到了无效响应。

怎么办检查上游服务,并用退避策略重试。

503Service Unavailable服务不可用

服务器过载或正在维护。

怎么办按 Retry-After 给出的时长重试。

504Gateway Timeout网关超时

网关没有及时收到上游服务器的响应。

怎么办检查上游延迟,并调长超时后重试。

505HTTP Version Not SupportedHTTP 版本不受支持

服务器不支持请求使用的 HTTP 版本。

怎么办改用 HTTP/1.1 或其他受支持的版本重试。

506Variant Also Negotiates变体协商错误

内容协商配置错误,协商结果又指回了自身。

怎么办修正服务器的协商配置;这是服务端缺陷。

507Insufficient Storage存储空间不足

WebDAV

WebDAV 服务器无法存储完成请求所需的表示。

怎么办释放存储空间,或减小请求体积。

508Loop Detected检测到循环

WebDAV

WebDAV 服务器在处理请求时发现了无限循环。

怎么办修正导致循环的配置或数据。

510Not Extended未扩展

已废弃

客户端必须声明服务器需要的 HTTP 扩展;该状态码已淘汰。

怎么办升级客户端,或改用受支持的 API。

511Network Authentication Required需要网络认证

认证

客户端需要先认证才能访问网络,例如公共 Wi-Fi 的登录门户。

怎么办打开网络登录页并完成认证。

怎么用

  1. 在搜索框里输入:数字(404)、英文官方短语(Not Found),或症状词(超时、限流)。列表随输入实时更新,没有提交按钮。
  2. 用 1xx–5xx 的 chip 收窄范围;它与搜索词叠加,例如「4xx 认证」只留下带认证标记的 4xx。
  3. 每张卡片给出码值、官方 reason phrase、含义和下一步建议。reason phrase 保持英文,因为 HTTP 报文里传的就是这串字符。
  4. 点卡片上的「复制」可复制规范的「404 Not Found」一行,写工单或提交信息时直接粘贴;「重置」同时清空搜索词与类别筛选。

示例

搜索

404

结果

404 Not Found —— 4xx · 客户端错误
服务器找不到请求的资源:可能是 URL 写错、路由未注册,或资源已被删除。
怎么办:核对 URL 与路由,并确认资源是否已被删除,再决定是否重试。

「404」是全角输入,页面先折成半角再匹配;搜索同样命中别名与症状词,例如「限流」能找到 429。「404 缓存」则按缓存说明同时找到 404 与 304。

范围与限制

  • 列表以 IANA HTTP Status Code Registry 为准:截至 2026-10-25 共 64 条。nginx 499、Cloudflare 52x 等厂商自定义码不在范围内。
  • 边缘项如实标注:104 仍是 Internet-Draft;102 / 305 / 510 已废弃;306 / 418 为保留,418 同时给出 RFC 2324 愚人节出处。
  • reason phrase 是官方 ASCII 原文,不做翻译;服务器可能返回不同的短语,但客户端真正依据的是三位数字。
  • 这是速查表,不是 URL 检测器:页面不会向任何站点发请求,因此无法判断某个网址为什么返回该状态码——那需要看对应服务器与日志。
  • 搜索完全在本页完成:不上传、不保存、不写进 URL;分享按钮只分享本页地址。

排查状态码前后的请求与响应时,这些工具通常用得上。