HTTP 与 Web 标准 / 知识点
HTTP 状态码速查手册
4xx 资源、条件与内容
HTTP/1.1 416 Range Not SatisfiableRange 请求无法满足。
416 Range Not Satisfiable
Range 请求无法满足。
典型场景
请求 byte 范围超出当前资源大小。
响应示例
HTTP/1.1 416 Range Not Satisfiable
Content-Type: application/json客户端处理
读取 Content-Range,重新计算合法范围。
易混 / 边界
常见于断点续传时本地偏移已经超过远端文件。
HTTP/1.1 417 Expectation Failed服务器无法满足请求 Expect 条件。
417 Expectation Failed
服务器无法满足请求 Expect 条件。
典型场景
Expect: 100-continue 或其他 expectation 不被支持。
响应示例
HTTP/1.1 417 Expectation Failed
Content-Type: application/json客户端处理
移除/调整 Expect,再重新请求。
易混 / 边界
较少见。
HTTP/1.1 418 UnusedRFC 9110/IANA 中该状态码为未使用保留位。
418 Unused
RFC 9110/IANA 中该状态码为未使用保留位。
典型场景
标准应用不应使用。
响应示例
HTTP/1.1 418 Unused
Content-Type: application/json客户端处理
若看到,多为玩笑实现或框架自定义。
易混 / 边界
“I'm a teapot” 是历史网络梗/旧实验语义,不是当前标准注册名称。
HTTP/1.1 421 Misdirected Request请求到达了无法为目标 URI 提供权威响应的服务器/连接。
421 Misdirected Request
请求到达了无法为目标 URI 提供权威响应的服务器/连接。
典型场景
HTTP/2 连接复用、SNI/Host/虚拟主机路由错配。
响应示例
HTTP/1.1 421 Misdirected Request
Content-Type: application/json客户端处理
可以在针对正确 origin 的新连接上重试。
易混 / 边界
不是普通 404,也不是网关 502。
HTTP/1.1 422 Unprocessable ContentContent-Type 可理解、语法也正确,但内容指令无法处理。
422 Unprocessable Content
Content-Type 可理解、语法也正确,但内容指令无法处理。
典型场景
JSON 格式正确,但字段校验、业务规则不满足。
响应示例
HTTP/1.1 422 Unprocessable Content
Content-Type: application/json客户端处理
修正字段或业务输入再提交。
易混 / 边界
旧资料常叫 Unprocessable Entity;RFC 9110 名称是 Unprocessable Content。
HTTP/1.1 423 Locked目标资源被锁定。
423 Locked
目标资源被锁定。
典型场景
WebDAV 写入锁定资源。
响应示例
HTTP/1.1 423 Locked
Content-Type: application/json客户端处理
等待/解除锁后重试。
易混 / 边界
普通数据库锁冲突不要求映射成 423。
HTTP/1.1 424 Failed Dependency当前操作因依赖的另一操作失败而失败。
424 Failed Dependency
当前操作因依赖的另一操作失败而失败。
典型场景
WebDAV 多操作依赖。
响应示例
HTTP/1.1 424 Failed Dependency
Content-Type: application/json客户端处理
先解决前置失败。
易混 / 边界
普通微服务下游失败通常不应机械返回 424。
4xx 限流、协议与扩展
HTTP/1.1 425 Too Early服务器拒绝可能遭受 TLS 0-RTT replay 风险的过早请求。
425 Too Early
服务器拒绝可能遭受 TLS 0-RTT replay 风险的过早请求。
典型场景
TLS early data / HTTP 0-RTT 场景。
响应示例
HTTP/1.1 425 Too Early
Content-Type: application/json客户端处理
客户端应在不使用 early data 的情况下重试。
易混 / 边界
主要用于防 replay,不是普通“请求太快”。
HTTP/1.1 426 Upgrade Required服务器要求客户端切换到指定协议。
426 Upgrade Required
服务器要求客户端切换到指定协议。
典型场景
服务要求升级协议版本。
响应示例
HTTP/1.1 426 Upgrade Required
Content-Type: application/json客户端处理
读取 Upgrade 等信息并按支持情况重试。
易混 / 边界
不是应用版本升级提示。
HTTP/1.1 428 Precondition Required服务器要求请求必须带条件,以避免丢失更新。
428 Precondition Required
服务器要求请求必须带条件,以避免丢失更新。
典型场景
更新资源时强制要求 If-Match。
响应示例
HTTP/1.1 428 Precondition Required
Content-Type: application/json客户端处理
先 GET 获得 ETag,再带条件提交。
易混 / 边界
412 是条件存在但失败;428 是缺少必须的条件。
HTTP/1.1 429 Too Many Requests客户端在给定时间内发送请求过多。
429 Too Many Requests
客户端在给定时间内发送请求过多。
典型场景
API 限流、登录防刷。
响应示例
HTTP/1.1 429 Too Many Requests
Content-Type: application/json客户端处理
读取 Retry-After/限流 Header,指数退避后再试。
易混 / 边界
不要立即高频重试,否则会加重限流。
HTTP/1.1 431 Request Header Fields Too Large请求 Header 总量或某个 Header 太大。
431 Request Header Fields Too Large
请求 Header 总量或某个 Header 太大。
典型场景
Cookie 过大、JWT/Header 链过长。
响应示例
HTTP/1.1 431 Request Header Fields Too Large
Content-Type: application/json客户端处理
缩小 Header、Cookie,或调整合理网关限制。
易混 / 边界
不是请求 body 太大;body 太大是 413。
HTTP/1.1 451 Unavailable For Legal Reasons因法律要求无法提供资源。
451 Unavailable For Legal Reasons
因法律要求无法提供资源。
典型场景
司法禁令、地区法律限制等。
响应示例
HTTP/1.1 451 Unavailable For Legal Reasons
Content-Type: application/json客户端处理
客户端通常只能展示法律限制说明或使用合法替代资源。
易混 / 边界
不是普通权限不足的 403。
5xx 服务端错误
HTTP/1.1 500 Internal Server Error服务器遇到未预期条件,无法完成请求。
500 Internal Server Error
服务器遇到未预期条件,无法完成请求。
典型场景
未捕获异常、内部逻辑错误。
响应示例
HTTP/1.1 500 Internal Server Error
Content-Type: application/json客户端处理
客户端可记录 request-id;是否重试取决于请求幂等性和错误性质。
易混 / 边界
不要用 500 包住所有业务错误。
HTTP/1.1 501 Not Implemented服务器不支持完成请求所需的功能。
501 Not Implemented
服务器不支持完成请求所需的功能。
典型场景
服务器根本不认识/不支持某 HTTP 方法或协议能力。
响应示例
HTTP/1.1 501 Not Implemented
Content-Type: application/json客户端处理
换用服务器支持的功能。
易混 / 边界
405 表示该资源不允许方法;501 表示服务器整体不支持该能力。
HTTP/1.1 502 Bad Gateway网关/代理从上游收到无效响应。
502 Bad Gateway
网关/代理从上游收到无效响应。
典型场景
Nginx/网关连接到应用后收到异常协议响应、连接被重置等。
响应示例
HTTP/1.1 502 Bad Gateway
Content-Type: application/json客户端处理
检查上游进程、端口、协议、日志;安全请求可有限重试。
易混 / 边界
504 是等待上游超时;502 更偏上游响应无效/连接异常。
HTTP/1.1 503 Service Unavailable服务当前暂时不可用。
503 Service Unavailable
服务当前暂时不可用。
典型场景
维护、过载、实例暂不可用。
响应示例
HTTP/1.1 503 Service Unavailable
Content-Type: application/json客户端处理
读取 Retry-After,退避后重试。
易混 / 边界
500 是意外内部错误;503 更强调暂时不可用。
HTTP/1.1 504 Gateway Timeout网关/代理等待上游响应超时。
504 Gateway Timeout
网关/代理等待上游响应超时。
典型场景
Nginx、API Gateway、LB 等等待后端太久。
响应示例
HTTP/1.1 504 Gateway Timeout
Content-Type: application/json客户端处理
检查上游耗时、依赖、超时配置和容量。
易混 / 边界
408 是客户端请求到服务器超时;504 是代理等待上游超时。
HTTP/1.1 505 HTTP Version Not Supported服务器不支持请求使用的 HTTP 版本。
505 HTTP Version Not Supported
服务器不支持请求使用的 HTTP 版本。
典型场景
客户端使用服务器不支持的 HTTP 主版本。
响应示例
HTTP/1.1 505 HTTP Version Not Supported
Content-Type: application/json客户端处理
改用服务器支持的协议版本。
易混 / 边界
不是 426;426 是服务器要求协议升级。
HTTP/1.1 506 Variant Also Negotiates透明内容协商配置出现循环引用。
506 Variant Also Negotiates
透明内容协商配置出现循环引用。
典型场景
RFC 2295 Transparent Content Negotiation。
响应示例
HTTP/1.1 506 Variant Also Negotiates
Content-Type: application/json客户端处理
服务端修正 representation negotiation 配置。
易混 / 边界
极少见。