Debug an API error
Look up the meaning and typical context of codes such as 401, 403, 409 or 422 quickly.
Loading…
Guide
The HTTP status page is a built-in reference table you can search by code, English name, meaning or description, and filter by 1xx informational, 2xx success, 3xx redirection, 4xx client error and 5xx server error. What it shows is static knowledge: it never sends an HTTP request to a domain or an endpoint you type.
Updated 2026-09-102 min read
404, “timeout” or a status name, or leave the box empty to browse everything.| Input | Output | Notes |
|---|---|---|
404 |
The 404 Not Found entry | Exact code search |
| “redirect” | Matching 3xx descriptions | Text search |
| Selecting 5xx | Server error classes only | Local filtering |
HTTP_STATUS list built into the repository, and its coverage moves with the application version rather than syncing with the IANA registry online.fetch, so it cannot tell you what status code a website currently returns.Look up the meaning and typical context of codes such as 401, 403, 409 or 422 quickly.
Browse grouped by 2xx, 3xx, 4xx and 5xx to build up the basic protocol concepts.
No. This page has no network capability at all; it only searches a local status code table.
No, it is built-in data released with the application.
The search keyword only filters a static table locally; no network request is sent.
Updated 2026-09-10
Quick reference for every 1xx–5xx status code with meaning and typical use
服务器已收到请求头，客户端应继续发送请求体。常见于大文件上传前的试探（Expect: 100-continue）。
服务器同意切换协议，最常见于 WebSocket 握手升级（Upgrade: websocket）。
WebDAV 扩展：服务器已收到并正在处理请求，但尚无响应可用，用于防止客户端超时。
在最终响应前先返回部分头部，常配合 Link 头让浏览器提前预加载 CSS/JS 资源。
请求成功。GET 返回资源内容，POST 返回处理结果，最常见的状态码。
资源创建成功，常见于 POST/PUT 创建记录后返回，通常配合 Location 头指向新资源。
请求已接受但尚未处理完成，适用于异步任务（如队列处理、批量导入）。
返回的元信息来自本地或第三方副本（如代理修改过），并非源服务器的权威版本。
处理成功但无返回内容，常见于 DELETE 成功、表单保存成功后不跳转的场景。
处理成功，并要求客户端重置视图（如清空表单），实践中很少使用。
范围请求成功，返回部分资源。视频拖动播放、断点续传下载都依赖它（Range 头）。
WebDAV 扩展：一次请求包含多个操作，响应体（XML）中分别给出各自的状态。
WebDAV 扩展：绑定的成员已在之前的响应中列举过，不再重复列举。
服务器已完成对资源的 GET 请求，响应是应用了实例操作（增量编码）后的结果。
资源有多个可选表述（如多语言版本），需要客户端或用户选择其一。
资源已永久迁移到新地址，搜索引擎会更新收录。域名更换、HTTP 转 HTTPS 常用。
资源临时位于其他地址。历史实现中客户端可能把 POST 改为 GET，需要保持方法时应使用 307。
要求客户端用 GET 访问另一地址获取结果，典型用于表单提交后跳转结果页（PRG 模式）。
资源自上次请求以来未变化，可继续使用本地缓存。配合 ETag / Last-Modified 实现协商缓存。
（已废弃）要求通过指定代理访问资源，出于安全原因现代浏览器不再支持。
与 302 类似，但明确要求重定向时不得改变请求方法与请求体（POST 仍为 POST）。
与 301 类似，但重定向时保持请求方法与请求体不变，适合 API 的永久迁移。
服务器无法理解请求：参数缺失、JSON 格式错误、请求语法不合法等，客户端应检查请求内容。
缺少或提供了无效的身份凭证（如 Token 过期）。语义上是「未登录」，应引导用户认证。
保留状态码，部分 API 服务用它表示配额用尽或需要付费订阅。
身份已确认但没有权限访问该资源（如普通用户访问管理接口），与 401 的区别在于认证与授权。
请求的资源不存在：URL 错误、资源已删除。最广为人知的状态码。
资源不支持该 HTTP 方法（如对只读接口发 POST），响应应包含 Allow 头列出允许的方法。
服务器无法生成满足 Accept 头要求的内容格式（如客户端只接受 XML 而服务器只有 JSON）。
与 401 类似，但要求先通过代理服务器的身份验证。
服务器等待请求发送完成超时（网络缓慢或客户端中断），客户端可稍后重试。
请求与资源当前状态冲突：重复创建同名资源、并发修改版本冲突等。
资源曾经存在但已被永久移除，且不会再恢复。比 404 语义更明确，利于搜索引擎清理收录。
服务器要求请求必须携带 Content-Length 头。
If-Match 等条件请求头不满足，常用于乐观锁：资源已被他人修改时阻止覆盖。
请求体超过服务器限制，常见于文件上传超限（如 Nginx 的 client_max_body_size）。
请求的 URL 超过服务器可处理的长度，常因 GET 参数堆积过多导致，应改用 POST。
请求体格式不被支持，如接口要求 application/json 却发送了表单格式。
Range 头请求的范围超出资源实际大小，常见于断点续传时本地记录与服务器文件不一致。
服务器无法满足 Expect 请求头的要求（如不支持 100-continue）。
1998 年愚人节玩笑（HTCPCP 协议）：茶壶拒绝煮咖啡。部分网站用它作为趣味防爬虫响应。
请求被发送到无法生成响应的服务器，常见于 HTTP/2 连接复用到错误的虚拟主机。
请求格式正确但语义无效：字段校验不通过（如邮箱格式错误），REST API 常用于表单校验失败。
WebDAV 扩展：资源被锁定，无法执行当前操作。
WebDAV 扩展：由于之前的请求失败，当前请求也无法完成。
服务器不愿处理可能被重放的早期数据（TLS 1.3 0-RTT 场景），避免重放攻击。
服务器拒绝使用当前协议处理，要求客户端升级（响应中 Upgrade 头指明目标协议）。
服务器要求请求必须携带条件头（如 If-Match），强制客户端使用乐观锁避免更新丢失。
触发限流。响应可带 Retry-After 头告知多久后可重试，是 API 限速的标准状态码。
请求头总大小或单个头字段超过限制，常见于 Cookie 膨胀过大。
因法律要求拒绝提供资源（如版权、监管封锁），编号致敬小说《华氏 451》。
服务器执行时发生未预期的错误（未捕获异常、代码 Bug 等），需要排查服务端日志。
服务器不支持该请求方法或功能，如向仅支持 GET/POST 的服务器发送 PATCH。
网关/反向代理从上游服务器收到无效响应，常见于后端服务崩溃、Nginx 上游连接被拒。
服务器暂时过载或停机维护，可配合 Retry-After 头。扩容、发布、熔断时常见。
网关/代理等待上游服务器响应超时，常见于后端处理过慢、数据库慢查询拖垮接口。
服务器不支持请求所用的 HTTP 协议版本。
服务器内容协商配置错误，选中的变体自身又参与协商，形成循环。
WebDAV 扩展：服务器无足够空间保存请求需要的内容（如磁盘已满）。
WebDAV 扩展：处理请求时检测到无限循环（如绑定关系形成环）。
请求缺少服务器要求的扩展信息，需进一步扩展后重试（极少使用）。
需要先通过网络层认证才能上网，典型场景是酒店/机场 Wi-Fi 的强制登录门户。