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 · 因法律原因不可用
因法律原因(审查、版权、隐私等)资源无法提供。
地区封锁 / 被要求删除的内容 / 版权投诉