返回开发者工具合集

HTTP 状态码速查

按状态码或关键字查含义与常见原因

共 62 条;当前显示 62 条

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