提示信息

HTTP 状态码速查

HTTP 响应状态码快速参考 · 共 52 个状态码
全部 52 1xx 信息 4 2xx 成功 8 3xx 重定向 7 4xx 客户端错误 23 5xx 服务端错误 10
1xx 信息响应 4 个
100
Continue · 继续
服务器已收到请求头,客户端应继续发送请求体(用于大请求的预检)。
客户端发送 Expect: 100-continue 时,服务器用此响应告知继续
101
Switching Protocols · 切换协议
服务器同意客户端升级协议的请求,将切换为更高版本的协议。
WebSocket 握手升级(Upgrade: websocket)
102
Processing · 处理中
服务器已收到并正在处理请求,但尚无响应可用(防止客户端超时)。
WebDAV 长时间操作(如复制大量文件)
103
Early Hints · 早期提示
服务器在最终响应前提前推送资源链接(Link 头),帮助浏览器预加载。
服务器提前告知 CSS/JS 资源链接以加速页面加载
2xx 成功响应 8 个
200
OK · 成功
请求成功,响应中包含所请求的数据。最常用的成功状态码。
GET 请求获取页面 / API 返回数据
201
Created · 已创建
请求成功且服务器已创建新的资源(通常用于 POST/PUT)。
RESTful API 创建新用户 / 发表新文章
202
Accepted · 已接受
请求已接受但尚未处理完成(异步任务),最终结果需另行查询。
异步任务提交(如视频转码、数据导出)
203
Non-Authoritative Information · 非权威信息
请求成功,但返回的元信息并非来自原始服务器,而是第三方副本。
代理服务器返回经修改的元数据
204
No Content · 无内容
请求成功,但响应中没有 body 内容(无需刷新页面)。
DELETE 操作成功 / 表单提交成功无返回数据
205
Reset Content · 重置内容
请求成功,同时指示客户端重置发送此请求的文档视图。
提交表单后清空输入框 / 重置编辑器状态
206
Partial Content · 部分内容
服务器成功处理了部分 GET 请求(断点续传 / 分块下载)。
视频拖拽播放 / 大文件下载续传(Range 头)
207
Multi-Status · 多状态
响应体包含多个独立操作的状态码(XML 格式)。WebDAV 扩展。
WebDAV 批量操作(多个文件的增删改)
3xx 重定向 7 个
300
Multiple Choices · 多种选择
请求的资源有多个可选表示,客户端需选择其一(如不同格式)。
同一资源有 JSON/XML/HTML 多种版本
301
Moved Permanently · 永久移动
资源已被永久移动到新 URL,客户端后续应使用新地址。搜索引擎也会更新。
网站域名变更 / HTTP→HTTPS 跳转 / URL 永久重写
302
Found · 临时移动
资源临时被移到新 URL,客户端应继续使用原地址(浏览器会跟随跳转)。
登录后跳转 / 临时维护页面 / A/B 测试
303
See Other · 查看其他
POST 请求的资源已在别处,应用 GET 方法获取新 URL(防止表单重复提交)。
表单提交后重定向到结果页(PRG 模式)
304
Not Modified · 未修改
资源未修改,客户端可使用本地缓存版本(无响应体,节省带宽)。
浏览器缓存协商(If-Modified-Since / ETag)
307
Temporary Redirect · 临时重定向
与 302 类似,但保证请求方法和 body 不变(不能改变 HTTP 方法)。
POST 请求临时重定向,方法保持为 POST
308
Permanent Redirect · 永久重定向
与 301 类似,但保证请求方法和 body 不变(不能改变 HTTP 方法)。
API 端点永久迁移,POST→POST、PUT→PUT
4xx 客户端错误 23 个
400
Bad Request · 错误请求
服务器无法理解请求的格式,客户端应修改请求后重试。
请求 JSON 格式错误 / 参数缺失或非法
401
Unauthorized · 未授权
请求需要身份验证,请求未包含有效的认证凭证。
未登录访问需要登录的页面 / Token 缺失或过期
402
Payment Required · 需要付款
保留用于未来数字支付系统(如小额支付)。极少使用。
预留状态码,部分 API 用于付费墙(需付费使用)
403
Forbidden · 禁止访问
服务器拒绝执行请求(已认证但无权限),不应重试。
普通用户访问管理员页面 / IP 被封禁
404
Not Found · 未找到
请求的资源不存在。可能是 URL 错误或资源已被删除。
访问不存在的页面 / 删除的资源链接 / 无效的 API 端点
405
Method Not Allowed · 方法不允许
请求方法(GET/POST/PUT 等)不被该资源支持。
只接受 POST 的端点收到 GET 请求 / 只读资源收到 DELETE
406
Not Acceptable · 无法接受
服务器无法提供符合 Accept 头要求的内容类型。
客户端要求 application/xml,但服务器只提供 JSON
407
Proxy Authentication Required · 需要代理认证
需要通过代理服务器的身份验证(类似 401 但用于代理层)。
企业代理认证 / VPN 网关要求登录
408
Request Timeout · 请求超时
服务器等待客户端发送请求的时间过长,连接被关闭。
慢速网络上传大文件超时 / 闲置连接被断开
409
Conflict · 冲突
请求与服务器当前状态冲突(如资源版本冲突、编辑冲突)。
多人编辑同篇文章 / 创建已有名称的资源
410
Gone · 已删除
请求的资源已被永久删除,且服务器知道该地址不会再提供。
已下架的商品页面 / 已删除的用户内容
411
Length Required · 需要长度
请求未提供 Content-Length 头但服务器需要它。
POST/PUT 请求缺少 Content-Length 头
412
Precondition Failed · 前提条件失败
请求头中的前提条件(If-Match / If-None-Match 等)评估为假。
条件更新:ETag 不匹配 / 资源已被修改
413
Payload Too Large · 负载过大
请求实体超过服务器限制的大小(原 413 Request Entity Too Large)。
上传文件超过服务器限制(如 10MB 限制)
414
URI Too Long · URI 过长
请求的 URI 长度超过服务器能解析的范围。
GET 请求参数过多 / 超长的路径名
415
Unsupported Media Type · 不支持的媒体类型
请求的 Content-Type 格式不被服务器支持。
上传图片但格式不是允许的 jpg/png / 错误的 Content-Type
418
I'm a Teapot · 我是茶壶
愚人节玩笑(HTCPCP/1.0 协议定义),服务器拒绝冲泡咖啡因为它是茶壶。
著名的愚人节彩蛋 / 部分网站用于反爬
422
Unprocessable Entity · 无法处理的实体
请求格式正确但语义错误,服务器无法处理(WebDAV 扩展)。
RESTful API 验证失败 / 必填字段为空 / 邮箱格式错误
425
Too Early · 太早
服务器不想处理可能被重放的请求(需配合 Early-Data 头)。
TLS 1.3 早期数据处理 / 防止重放攻击
426
Upgrade Required · 需要升级
服务器拒绝当前协议请求,要求客户端升级到更新的协议。
要求使用 HTTP/2 而非 HTTP/1.1 / TLS 升级
429
Too Many Requests · 请求过多
客户端在限定的时间内发送了太多请求(限流/速率限制)。
API 限流触发 / 短时间重复请求被拦截(含 Retry-After 头)
431
Request Header Fields Too Large · 请求头过大
请求头字段或整个头的体积超过服务器限制。
Cookie 太大 / 带有过长的 Authorization 头
451
Unavailable For Legal Reasons · 因法律原因不可用
因法律原因(审查、版权、隐私等)资源无法提供。
地区封锁 / 被要求删除的内容 / 版权投诉
5xx 服务端错误 10 个
500
Internal Server Error · 服务器内部错误
服务器遇到意外情况,无法完成请求。通用服务端错误。
代码异常 / 数据库连接失败 / 未捕获的错误
501
Not Implemented · 未实现
服务器不支持请求的方法或功能(无法识别请求方法时返回)。
服务器不支持 PATCH 方法 / 尚未开发的功能
502
Bad Gateway · 网关错误
网关或代理从上游服务器收到无效响应。
Nginx 背后应用崩溃 / 上游 API 不可用
503
Service Unavailable · 服务不可用
服务器暂时无法处理请求(超载或维护中),通常稍后可恢复。
服务器维护 / 流量高峰过载 / CDN 回源失败
504
Gateway Timeout · 网关超时
网关或代理等待上游服务器响应超时。
Nginx 上游 PHP-FPM 超时 / 数据库慢查询
505
HTTP Version Not Supported · HTTP 版本不支持
服务器不支持或拒绝支持请求中使用的 HTTP 协议版本。
老旧服务器不支持 HTTP/2
506
Variant Also Negotiates · 变体也协商
服务器存在内部配置错误,导致内容协商循环引用。
透明内容协商服务器配置错误
507
Insufficient Storage · 存储空间不足
服务器存储空间不足,无法完成请求(WebDAV 扩展)。
网盘上传文件时磁盘满 / 服务器硬盘容量不足
508
Loop Detected · 检测到循环
服务器在处理请求时检测到无限循环(WebDAV 扩展)。
WebDAV 深度递归时出现循环引用
511
Network Authentication Required · 需要网络认证
客户端需要通过网络认证才能访问(如强制门户的登录页面)。
连接公共 Wi-Fi 时跳转认证页面 / 酒店/机场 Wi-Fi 登录

未找到匹配的状态码

试试搜索 "404"、"成功"、"超时" 等关键词

显示 51 / 51 个状态码

© 2026 xiong da. All rights reserved.

GitHub Repository