1xx–5xx 전체 상태 코드를 의미와 사용 사례와 함께 빠르게 찾아봅니다
이 도구는 아직 완전히 번역되지 않아 일부 내용이 원문 또는 대체 언어로 표시됩니다.
服务器已收到请求头,客户端应继续发送请求体。常见于大文件上传前的试探(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 的强制登录门户。