返回开发者工具合集
HTTP 状态码速查
按状态码或关键字查含义与常见原因
共 62 条;当前显示 62 条
| 状态码 | 名称 | 含义 | 常见原因 / 处理建议 |
|---|---|---|---|
| 100 | Continue | 继续:服务器已收到请求头,客户端可以继续发送请求体。 | 客户端发送 `Expect: 100-continue` 后等待此响应再发正文;若服务器直接回最终状态码,则不要再发正文。 |
| 101 | Switching Protocols | 切换协议:服务器按 `Upgrade` 请求头切换到另一种协议。 | 常见于 WebSocket 握手:客户端发 `Upgrade: websocket`,服务器同意后回 101,连接随即改用新协议。 |
| 102 | Processing | 处理中:服务器已收到并正在处理请求,但还没有可用响应(WebDAV)。 | 长耗时操作时用于保活,防止客户端超时;普通 HTTP 请求很少使用。 |
| 103 | Early Hints | 早期提示:在最终响应前先返回部分响应头,让客户端提前准备资源。 | 常配合 `Link: rel=preload` 预加载 CSS/字体;浏览器收到后可以提前发起请求,缩短首屏时间。 |
| 200 | OK | 成功:请求已成功,响应体包含结果。 | 最常见的结果。若是 API 调用,注意检查响应体里的业务错误字段,HTTP 200 不等于业务成功。 |
| 201 | Created | 已创建:请求成功并新建了资源。 | 通常用于 POST 创建资源,响应头 `Location` 给出新资源的地址;响应体可带创建后的表示。 |
| 202 | Accepted | 已接受:请求已进入处理流程,但尚未处理完成。 | 适用于异步任务(排队、后台处理):告诉客户端稍后再查询进度,别把它当成「已经完成」。 |
| 203 | Non-Authoritative Information | 非授权信息:响应来自代理,内容可能被转换过。 | 缓存代理返回自己改写过的内容时使用;客户端拿到的不是源站原始表示。 |
| 204 | No Content | 无内容:请求已成功,但没有响应体。 | 常用于 DELETE / PUT 成功后的空响应;客户端不要尝试解析正文,浏览器也不会改变当前页面。 |
| 205 | Reset Content | 重置内容:请求成功,要求客户端重置文档视图(如清空表单)。 | 表单提交成功后要求清空输入时使用;与 204 的区别是明确要求客户端重置界面状态。 |
| 206 | Partial Content | 部分内容:服务器按 `Range` 请求只返回了资源的一部分。 | 视频拖动进度条、断点续传依赖它;响应必须带 `Content-Range`,并正确处理 `If-Range`。 |
| 207 | Multi-Status | 多状态:响应体里包含多个独立操作的结果(WebDAV)。 | 批量操作(如批量删除文件)时逐项报告成功/失败;响应体是 XML 的 `multistatus`。 |
| 208 | Already Reported | 已报告:同一集合的成员已在之前的响应中报告过(WebDAV)。 | 避免在深层目录的 `PROPFIND` 响应里重复列举同一个绑定;普通 Web 场景基本不会遇到。 |
| 226 | IM Used | 已使用实例操纵:服务器对资源应用了增量编码(delta encoding)。 | 响应需带 `Delta-Base` 说明基线版本;用于节省带宽的增量更新,日常开发很少直接处理。 |
| 300 | Multiple Choices | 多种选择:资源有多个可选表示,需要客户端选择。 | 响应体应列出可选表示及各自 URI;现代 API 很少用,通常由内容协商或前端路由替代。 |
| 301 | Moved Permanently | 永久重定向:资源已永久迁到新地址。 | 需在 `Location` 给出新地址;搜索引擎会更新索引。旧地址若仍可访问,不要让新地址再指回旧地址(会形成循环)。 |
| 302 | Found | 临时重定向:资源临时在另一个地址。 | `Location` 给临时地址;客户端应继续对原地址发起请求。历史浏览器会把 POST 改成 GET 跟随,需要保持方法请用 307。 |
| 303 | See Other | 查看其他位置:请求的响应在另一个 URI,客户端应改用 GET 获取。 | POST 处理完成后跳转到结果页(PRG 模式)的标准做法;无论原请求是什么方法,跟随都用 GET。 |
| 304 | Not Modified | 未修改:资源自客户端缓存以来没有变化,可直接使用缓存。 | 由 `If-None-Match` / `If-Modified-Since` 触发;响应不能带正文。若内容明明改了却一直 304,检查 ETag 是否没随内容更新。 |
| 305 | Use Proxy | 使用代理:资源必须通过响应头指定的代理访问(已废弃)。 | 因安全原因被 RFC 9110 弃用,不要在新实现里使用;需要代理请走网络层配置。 |
| 307 | Temporary Redirect | 临时重定向:资源临时在另一个地址,且要求保持原请求方法。 | 与 302 的区别是跟随重定向时方法不变(POST 仍为 POST);做临时维护跳转又不想丢请求体时用它。 |
| 308 | Permanent Redirect | 永久重定向:资源已永久迁走,且要求保持原请求方法。 | 与 301 的区别是方法不变(POST 仍为 POST);注意浏览器会长期缓存 308,配错了很难撤销。 |
| 400 | Bad Request | 错误请求:请求语法有误,服务器无法解析。 | 检查请求体 JSON 是否合法、必填字段是否缺失、Content-Type 是否匹配;错误响应里应指明哪个字段不对。 |
| 401 | Unauthorized | 未认证:请求缺少有效凭证,需要先登录。 | 响应头 `WWW-Authenticate` 说明认证方式;注意它语义是「未认证」,不是「已登录但无权限」(那是 403)。 |
| 402 | Payment Required | 需要付款:保留状态码,供付费接口使用。 | 规范未定义标准行为;部分服务用它在余额不足时拒绝请求,具体含义看该服务的 API 文档。 |
| 403 | Forbidden | 禁止访问:服务器理解了请求,但拒绝执行。 | 通常是权限不足或请求被安全策略拦截;与 401 不同,重新登录也没用。检查账号角色、IP 白名单与 CSRF 校验。 |
| 404 | Not Found | 未找到:请求的资源不存在。 | 检查 URL 拼写、路由是否注册、资源是否被删除;接口也可能用 404 隐藏「存在但无权访问」的资源。 |
| 405 | Method Not Allowed | 方法不允许:资源存在,但不支持该 HTTP 方法。 | 检查用的是 GET 还是 POST;响应头 `Allow` 会列出支持的方法。常见于把表单 POST 提交到了只接受 PUT 的接口。 |
| 406 | Not Acceptable | 不可接受:服务器无法提供符合 `Accept` 头要求的内容。 | 内容协商失败:客户端只接受 JSON 而服务端只能返回 XML 时会这样。检查 `Accept` 头,或让服务端补上对应格式。 |
| 407 | Proxy Authentication Required | 需要代理认证:必须先通过代理服务器的认证。 | 响应头 `Proxy-Authenticate` 说明认证方式;多见于企业网络代理,检查代理配置与凭据。 |
| 408 | Request Timeout | 请求超时:服务器在等待请求时超时。 | 客户端发送太慢、网络中断或请求体过大迟迟发不完;客户端可重试,服务端可适当调大读超时。 |
| 409 | Conflict | 冲突:请求与目标资源的当前状态冲突。 | 常见于并发修改、唯一键冲突与版本号不匹配;响应里应说明冲突原因,客户端需刷新后重试。 |
| 410 | Gone | 已删除:资源之前存在,现已永久不可用。 | 与 404 的区别是明确「曾经有、以后也不会有」;适合已下架内容,搜索引擎会更快移除索引。 |
| 411 | Length Required | 需要长度:请求缺少 `Content-Length`。 | 带请求体时必须声明长度(或用分块传输);检查客户端是否漏了该头。 |
| 412 | Precondition Failed | 前置条件失败:`If-Match` 等条件不满足。 | 乐观并发控制里常见:资源已被别人改过,客户端应重新拉取最新版本再合并。 |
| 413 | Content Too Large | 内容过大:请求体超过服务器允许的大小。 | 检查上传文件大小与 `client_max_body_size`(nginx)等限制;大文件应改成分片上传,而不是调大全局上限。 |
| 414 | URI Too Long | URI 过长:请求地址超过服务器允许的长度。 | GET 参数太多或太长;把大批量数据改为请求体提交(POST),或分页。 |
| 415 | Unsupported Media Type | 不支持的媒体类型:请求体的格式不被接口接受。 | 检查 `Content-Type`(例如接口只收 `application/json` 却发了表单);上传接口还要检查文件类型白名单。 |
| 416 | Range Not Satisfiable | 范围无法满足:`Range` 指定的区间超出资源大小。 | 响应头 `Content-Range: bytes */<总长度>` 告诉客户端合法范围;断点续传时检查本地记录的文件长度。 |
| 417 | Expectation Failed | 期望失败:无法满足 `Expect` 请求头。 | 通常是 `Expect: 100-continue` 无法满足;检查中间代理是否支持,或让客户端不再发送该头。 |
| 418 | I'm a teapot | 我是茶壶:RFC 2324 的愚人节彩蛋,表示服务器拒绝煮咖啡。 | 不是业务状态码;部分服务拿它当「我就是不处理」的玩笑或风控拒绝,遇到时看具体服务的文档。 |
| 421 | Misdirected Request | 请求方向错误:请求被发到了无法为该域名提供服务的服务器。 | 常见于 HTTP/2 连接复用与 SNI 不匹配:客户端应换一条新连接重试;检查证书与虚拟主机配置。 |
| 422 | Unprocessable Content | 无法处理的实体:请求格式正确,但语义上有错误。 | 字段校验失败时用它比 400 更精确(例如邮箱格式不对);响应里应逐字段给出原因。旧名 Unprocessable Entity。 |
| 423 | Locked | 已锁定:资源被锁定,无法访问(WebDAV)。 | WebDAV 中别人正在编辑文件时会这样;检查锁令牌,或等待锁释放。 |
| 424 | Failed Dependency | 依赖失败:因为前置操作失败,本次操作未执行(WebDAV)。 | 批量/事务性操作里,前面的步骤失败会让后续步骤回 424;应从响应里找到真正失败的依赖项。 |
| 425 | Too Early | 过早:服务器不愿处理可能被重放的早期数据。 | TLS 1.3 0-RTT 数据有重放风险,服务器可拒绝;客户端应等握手完成后再重试。 |
| 426 | Upgrade Required | 需要升级:必须改用更安全的协议(如 HTTPS / 更高版本 HTTP)。 | 响应头 `Upgrade` 说明要求;浏览器收到 426 不会自动升级,通常由服务端直接 301 跳到 HTTPS。 |
| 428 | Precondition Required | 需要前置条件:服务器要求请求带上条件头,防止丢失更新。 | 服务端要求 `If-Match` / `If-Unmodified-Since`;客户端先读版本号,再带条件写回。 |
| 429 | Too Many Requests | 请求过多:触发了限频。 | 看 `Retry-After` 等待指定秒数再重试;客户端应做退避,别在同一秒继续重试。 |
| 431 | Request Header Fields Too Large | 请求头字段过大:单个或全部请求头超过服务器限制。 | 常见原因是 Cookie 太大或 token 太长;减少 Cookie 体积、拆分请求头,或调整服务端上限。 |
| 451 | Unavailable For Legal Reasons | 因法律原因不可用:内容因法律要求被屏蔽。 | 通常附带解释链接(如 DMCA);不要用它掩盖普通的权限问题。 |
| 500 | Internal Server Error | 服务器内部错误:服务器遇到未预期的情况,无法完成请求。 | 看服务端日志里的堆栈(响应体不应暴露内部细节);常见于空指针、数据库异常与未捕获的异步错误。 |
| 501 | Not Implemented | 未实现:服务器不支持该请求所需的功能。 | 通常是方法未被实现(例如接口只写了 GET,客户端却发 PATCH);检查服务端路由与反向代理是否转发。 |
| 502 | Bad Gateway | 网关错误:网关/代理从上游收到无效响应。 | 上游进程崩了、端口没监听、超时后被断开;检查上游服务状态与 nginx 的 `proxy_pass` 地址。 |
| 503 | Service Unavailable | 服务不可用:服务器暂时无法处理请求(过载或维护)。 | 若能预计恢复时间,带 `Retry-After`;检查是否因连接池耗尽、线程打满或正在发布而暂时下线。 |
| 504 | Gateway Timeout | 网关超时:网关/代理等待上游响应超时。 | 上游处理太慢或卡死;检查慢查询、外部依赖超时与 `proxy_read_timeout`,不要简单地把超时时间调大掩盖问题。 |
| 505 | HTTP Version Not Supported | HTTP 版本不支持:服务器不支持请求使用的 HTTP 版本。 | 检查客户端/代理是否发了服务器不支持的版本(如 HTTP/2 over cleartext);统一协议版本后重试。 |
| 506 | Variant Also Negotiates | 变体也会协商:内容协商配置错误导致循环。 | 服务端的内容协商指向了另一个会再次协商的资源;检查 `Vary` 与协商配置,这属于服务端配置问题。 |
| 507 | Insufficient Storage | 存储空间不足:服务器无法保存完成请求所需的内容(WebDAV)。 | 检查磁盘配额与临时目录空间;清理空间或扩容后重试。 |
| 508 | Loop Detected | 检测到循环:服务器处理请求时发现无限循环(WebDAV)。 | 目录绑定形成了环或重定向链成环;检查文件系统挂载点/符号链接与重定向规则。 |
| 510 | Not Extended | 未扩展:服务器要求对请求做进一步扩展才能处理。 | 响应会说明需要哪些扩展;普通 Web 场景几乎不会遇到。 |
| 511 | Network Authentication Required | 需要网络认证:客户端需要先完成网络接入认证。 | 常见于酒店/机场 Wi-Fi 的强制门户(captive portal);完成认证页登录后重试,或让客户端处理门户跳转。 |