切换工具
浏览全部工具

HTTP 状态码速查表

1xx~5xx 全量状态码中文速查:含义、排障要点、搜索过滤

61 / 61 条
状态码分类英文名说明
1001xxContinue继续。客户端应继续发送请求体,用于带 Expect: 100-continue 的大请求预检。
1011xxSwitching Protocols切换协议。服务器同意升级协议,最常见于 WebSocket 握手(Upgrade: websocket)。
1021xxProcessing处理中(WebDAV)。服务器已收到请求但尚未完成,用于防止客户端超时。
1031xxEarly Hints早期提示。在最终响应前先返回 Link 头,让浏览器预加载 CSS/JS 等资源。
2002xxOK成功。GET 请求返回资源本体,POST 返回处理结果。
2012xxCreated已创建。资源创建成功,响应头应带 Location 指向新资源地址。
2022xxAccepted已接受。请求已进入异步处理队列,结果需轮询或回调获取,不保证最终成功。
2032xxNon-Authoritative Information非权威信息。代理/网关返回的元信息与源服务器不完全一致。
2042xxNo Content无内容。处理成功但没有返回体,常用于 PUT/DELETE/PATCH 的成功响应。
2052xxReset Content重置内容。要求客户端重置当前视图(如清空表单),响应无本体。
2062xxPartial Content部分内容。Range 断点续传/视频拖动的标准响应,Content-Range 标明区间。
2072xxMulti-Status多状态(WebDAV)。一个请求涉及多个资源,各自状态在 XML/JSON 体里分别给出。
2082xxAlready Reported已报告(WebDAV)。绑定集合中重复成员不再重复展开。
2262xxIM Used已使用实例操作(Delta encoding)。返回的是增量而非全量。
3003xxMultiple Choices多种选择。资源有多个表示形式(如多语言版本),由客户端选择。
3013xxMoved Permanently永久重定向。资源已永久迁移,SEO 权重转移用这个;浏览器会缓存。
3023xxFound临时重定向。资源暂时在别处,浏览器不缓存;登录后跳转常用。
3033xxSee Other参见其他。明确要求用 GET 去取响应,POST 成功后重定向到结果页的规范做法。
3043xxNot Modified缓存有效。协商缓存命中(If-None-Match/If-Modified-Since),无响应体,省流量。
3073xxTemporary Redirect临时重定向且保持方法。302 会被浏览器把 POST 改成 GET,307 严格保留原方法与请求体。
3083xxPermanent Redirect永久重定向且保持方法。301 的严格版,重定向后不复用缓存的旧方法。
4004xxBad Request请求语法错误/参数校验失败。最常见于 JSON 格式错、缺必填字段。
4014xxUnauthorized未认证。缺少或无效的登录凭证(token/签名),响应头应带 WWW-Authenticate。
4024xxPayment Required要求付费。标准保留未广泛使用,个别 API 用它表示额度/套餐不足。
4034xxForbidden已认证但无权限。与 401 的区别:身份没问题,但该身份不被允许访问此资源。
4044xxNot Found资源不存在。也可能是权限不想暴露时的伪装返回。
4054xxMethod Not Allowed方法不允许。URL 存在但不支持该 HTTP 方法(如对只读接口发 DELETE),响应 Allow 头列出可用方法。
4064xxNot Acceptable无法满足 Accept 协商。服务器给不出客户端要求的内容格式。
4074xxProxy Authentication Required需要代理认证。客户端需先通过代理服务器的身份验证。
4084xxRequest Timeout请求超时。客户端发送请求太慢,服务器超时断开。
4094xxConflict状态冲突。资源当前状态与请求冲突,如并发编辑、重复创建、版本不匹配。
4104xxGone资源已永久消失。比 404 更明确的"不再存在且无新地址",爬虫会移除收录。
4114xxLength Required要求 Content-Length。服务器拒绝不定长的请求。
4124xxPrecondition Failed前置条件失败。If-Match/If-Unmodified-Since 等条件不满足,乐观锁冲突的典型返回。
4134xxContent Too Large请求体过大。上传文件超限的标配返回,配合 429 的区别:这是体积不是频率。
4144xxURI Too LongURI 过长。GET 塞了过多参数时出现,改 POST 请求体。
4154xxUnsupported Media Type媒体类型不支持。Content-Type 不是接口接受的格式(如要 JSON 发了 form)。
4164xxRange Not Satisfiable区间不可满足。断点续传的 Range 超出资源大小。
4174xxExpectation FailedExpect 头无法满足。
4184xxI'm a teapot我是一个茶壶。1998 愚人节彩蛋(HTCPCP),请求用茶壶煮咖啡;现也常被占用于彩蛋页。
4214xxMisdirected Request请求发错地方。HTTP/2 多路复用下连接选错服务器(SNI 不匹配)。
4224xxUnprocessable Content语义错误。格式合法但业务校验失败(字段值非法),表单/API 校验的推荐返回。
4234xxLocked资源已锁(WebDAV)。别人锁着编辑中。
4244xxFailed Dependency依赖请求失败(WebDAV)。批量操作里前一步挂了导致本步不执行。
4254xxToo Early过早。服务器不愿处理可能被重放攻击利用的早期请求。
4264xxUpgrade Required要求升级协议。客户端需切换到 TLS/HTTP2 等(Upgrade 头指明)。
4284xxPrecondition Required要求前置条件。服务器要求请求带 If-Match 防止丢失更新(先读后写竞态)。
4294xxToo Many Requests请求过多。限流触发,标准响应头 Retry-After 给出重试等待时间。
4314xxRequest Header Fields Too Large请求头过大。常见于 Cookie 堆积过多,清理站点 Cookie 可解。
4514xxUnavailable For Legal Reasons因法律原因不可用。地区屏蔽/版权下架使用的正式状态码。
5005xxInternal Server Error服务器内部错误。未捕获异常的兜底返回,排查看服务端日志堆栈。
5015xxNot Implemented未实现。服务器不支持该功能(方法/协议特性),不是临时故障。
5025xxBad Gateway网关错误。代理/网关从上游收到无效响应——上游挂了、崩溃、返回格式错。
5035xxService Unavailable服务不可用。过载或维护中,常配 Retry-After;负载均衡摘除节点时常见。
5045xxGateway Timeout网关超时。上游在时限内没响应——慢 SQL、死循环、依赖服务卡死的典型信号。
5055xxHTTP Version Not SupportedHTTP 版本不支持。
5065xxVariant Also Negotiates变体协商配置错误(透明内容协商)。服务器端配置问题。
5075xxInsufficient Storage存储不足(WebDAV)。服务器没空间完成请求。
5085xxLoop Detected检测到循环(WebDAV)。处理时陷入无限循环。
5105xxNot Extended未扩展。要求的扩展策略服务器不支持。
5115xxNetwork Authentication Required需要网络认证。公共 WiFi 登录墙的返回,响应体是登录页。
收录 RFC 9110(原 7231)、RFC 6585、RFC 7725、RFC 9110 之外的 WebDAV 扩展码共 61 个,是排障接口、写网关/监控告警规则时的速查底表。

使用说明

按分类 tab(信息/成功/重定向/客户端错误/服务端错误)浏览,或在搜索框输入码值(502)、英文短语(Unauthorized)与中文关键词(限流)即时过滤。

每个状态码的说明都写明了高频排障方向:502 与 504 的区别(上游返回无效响应 vs 上游超时没响应)、401 与 403 的区别(没登录 vs 没权限)、301/302/307/308 的方法保留语义差异。

写接口文档、网关路由与监控告警规则时可直接对照本表选码:业务校验失败推荐 422 而不是 400、限流必须是 429 且带 Retry-After、异步任务受理用 202 表达「已排队」。

常见问题

502 Bad Gateway:网关/代理收到了上游的无效响应——上游进程崩了或返回格式错;503 Service Unavailable:服务明确表示暂不可用(过载、维护),通常带 Retry-After;504 Gateway Timeout:上游在时限内根本没响应——慢查询、死循环的典型信号。排查顺序:先看 504 查上游耗时,再看 502 查上游进程日志。

相关阅读

全部文章 →

开发工具的其他工具