HTTP 与 Web 标准 / 知识点
HTTP 状态码速查手册
3xx 重定向
HTTP/1.1 305 Use Proxy历史上要求通过指定代理访问资源。
305 Use Proxy
历史上要求通过指定代理访问资源。
典型场景
历史 HTTP 实现。
响应示例
HTTP/1.1 305 Use Proxy
Content-Type: application/json客户端处理
新系统不要使用。
易混 / 边界
因安全与部署问题已不适合作为现代应用设计。
HTTP/1.1 306 Unused保留但未使用的状态码。
306 Unused
保留但未使用的状态码。
典型场景
不应在应用中返回。
响应示例
HTTP/1.1 306 Unused
Content-Type: application/json客户端处理
遇到时按非标准/异常实现排查。
易混 / 边界
不要自行赋予业务含义。
HTTP/1.1 307 Temporary Redirect临时重定向,并要求保留原请求方法和 body。
307 Temporary Redirect
临时重定向,并要求保留原请求方法和 body。
典型场景
POST/PUT 临时迁移到另一地址。
响应示例
HTTP/1.1 307 Temporary Redirect
Content-Type: application/json客户端处理
按 Location 重发相同方法和内容。
易混 / 边界
与 302 的关键区别是 307 明确保留方法。
HTTP/1.1 308 Permanent Redirect永久重定向,并要求保留原请求方法和 body。
308 Permanent Redirect
永久重定向,并要求保留原请求方法和 body。
典型场景
API 永久迁移且不能把 POST 变 GET。
响应示例
HTTP/1.1 308 Permanent Redirect
Content-Type: application/json客户端处理
后续使用新 URI,并保持原方法。
易混 / 边界
可以理解为“保留方法版的 301”。
4xx 请求、认证与权限
HTTP/1.1 400 Bad Request服务器认为请求本身存在语法、消息 framing 或路由等客户端错误。
400 Bad Request
服务器认为请求本身存在语法、消息 framing 或路由等客户端错误。
典型场景
JSON 语法错误、参数格式根本无法解析、非法请求格式。
响应示例
HTTP/1.1 400 Bad Request
Content-Type: application/json客户端处理
修正请求再发送,不应原样无限重试。
易混 / 边界
业务字段语义校验失败更适合 422。
HTTP/1.1 401 Unauthorized请求缺少有效的目标资源认证凭据。
401 Unauthorized
请求缺少有效的目标资源认证凭据。
典型场景
Token 缺失、Token 无效、Basic Auth 失败。
响应示例
HTTP/1.1 401 Unauthorized
Content-Type: application/json客户端处理
根据 WWW-Authenticate 重新认证或刷新凭据。
易混 / 边界
401 实际是“未认证/认证失败”;已经认证但没权限通常是 403。
HTTP/1.1 402 Payment Required为未来支付相关语义保留。
402 Payment Required
为未来支付相关语义保留。
典型场景
标准没有定义通用支付流程。
响应示例
HTTP/1.1 402 Payment Required
Content-Type: application/json客户端处理
只有明确 API 约定时使用。
易混 / 边界
不要认为 402 已有统一浏览器支付语义。
HTTP/1.1 403 Forbidden服务器理解请求,也可能知道身份,但拒绝执行。
403 Forbidden
服务器理解请求,也可能知道身份,但拒绝执行。
典型场景
已登录用户没有角色/资源权限、策略拒绝。
响应示例
HTTP/1.1 403 Forbidden
Content-Type: application/json客户端处理
不要反复刷新 Token;检查授权与策略。
易混 / 边界
401 是认证问题,403 是权限/策略问题。
HTTP/1.1 404 Not Found服务器没有找到目标资源,或选择隐藏资源存在性。
404 Not Found
服务器没有找到目标资源,或选择隐藏资源存在性。
典型场景
ID 不存在、URL 不存在。
响应示例
HTTP/1.1 404 Not Found
Content-Type: application/json客户端处理
修正 URI 或确认资源是否存在。
易混 / 边界
永久删除且希望表达明确语义可用 410。
HTTP/1.1 405 Method Not Allowed资源存在,但不支持当前 HTTP 方法。
405 Method Not Allowed
资源存在,但不支持当前 HTTP 方法。
典型场景
对只支持 GET 的资源发送 POST。
响应示例
HTTP/1.1 405 Method Not Allowed
Content-Type: application/json客户端处理
读取 Allow,改用支持的方法。
易混 / 边界
404 是资源不存在;405 是资源存在但方法不允许。
HTTP/1.1 406 Not Acceptable服务器无法产生满足请求内容协商条件的 representation。
406 Not Acceptable
服务器无法产生满足请求内容协商条件的 representation。
典型场景
Accept 要求 XML,但服务端只能返回 JSON。
响应示例
HTTP/1.1 406 Not Acceptable
Content-Type: application/json客户端处理
调整 Accept / Accept-Language 等协商条件。
易混 / 边界
不要和 415 混淆:406 针对“响应格式”,415 针对“请求内容格式”。
HTTP/1.1 407 Proxy Authentication Required访问代理需要认证。
407 Proxy Authentication Required
访问代理需要认证。
典型场景
企业 HTTP 代理要求登录。
响应示例
HTTP/1.1 407 Proxy Authentication Required
Content-Type: application/json客户端处理
根据 Proxy-Authenticate 提供 Proxy-Authorization。
易混 / 边界
它是代理认证,不是目标服务器的 401。
HTTP/1.1 408 Request Timeout服务器等待客户端完成请求时超时。
408 Request Timeout
服务器等待客户端完成请求时超时。
典型场景
客户端发送请求头/body 太慢或连接停滞。
响应示例
HTTP/1.1 408 Request Timeout
Content-Type: application/json客户端处理
安全且可重试的请求可以重新建立连接重试。
易混 / 边界
与 504 不同:408 是客户端→服务器请求阶段超时。
4xx 资源、条件与内容
HTTP/1.1 409 Conflict请求与资源当前状态发生冲突。
409 Conflict
请求与资源当前状态发生冲突。
典型场景
版本冲突、唯一键冲突、状态机不允许当前操作。
响应示例
HTTP/1.1 409 Conflict
Content-Type: application/json客户端处理
读取冲突原因,刷新资源状态后决定是否重试。
易混 / 边界
422 是请求内容本身无法处理;409 更强调当前资源状态冲突。
HTTP/1.1 410 Gone资源曾存在,但服务器确认已永久删除且不再提供。
410 Gone
资源曾存在,但服务器确认已永久删除且不再提供。
典型场景
永久下线内容、明确删除的公开资源。
响应示例
HTTP/1.1 410 Gone
Content-Type: application/json客户端处理
客户端应停止继续请求旧 URI。
易混 / 边界
404 不承诺是否永久;410 明确表达已永久消失。
HTTP/1.1 411 Length Required服务器要求请求提供 Content-Length。
411 Length Required
服务器要求请求提供 Content-Length。
典型场景
服务器/网关不接受没有明确长度的请求。
响应示例
HTTP/1.1 411 Length Required
Content-Type: application/json客户端处理
补充合法 Content-Length 或调整发送方式。
易混 / 边界
现代 HTTP API 中较少直接遇到。
HTTP/1.1 412 Precondition Failed请求中的条件 Header 校验失败。
412 Precondition Failed
请求中的条件 Header 校验失败。
典型场景
If-Match、If-Unmodified-Since 等乐观锁条件不成立。
响应示例
HTTP/1.1 412 Precondition Failed
Content-Type: application/json客户端处理
重新读取资源状态,再决定是否提交。
易混 / 边界
428 是服务器要求你必须带条件;412 是你带了条件但条件失败。
HTTP/1.1 413 Content Too Large请求内容超过服务器允许大小。
413 Content Too Large
请求内容超过服务器允许大小。
典型场景
上传文件或 JSON body 超过限制。
响应示例
HTTP/1.1 413 Content Too Large
Content-Type: application/json客户端处理
缩小请求、分片,或调整网关/服务端限制。
易混 / 边界
旧资料常写 Payload Too Large;RFC 9110 名称为 Content Too Large。
HTTP/1.1 414 URI Too Long请求 URI 长度超过服务器可接受范围。
414 URI Too Long
请求 URI 长度超过服务器可接受范围。
典型场景
把大量数据塞进 query string。
响应示例
HTTP/1.1 414 URI Too Long
Content-Type: application/json客户端处理
改用请求 body 或缩短 URI。
易混 / 边界
不是 body 太大;body 太大是 413。
HTTP/1.1 415 Unsupported Media Type服务器不支持请求内容的媒体类型或编码。
415 Unsupported Media Type
服务器不支持请求内容的媒体类型或编码。
典型场景
API 要 JSON,却发送 text/plain/XML。
响应示例
HTTP/1.1 415 Unsupported Media Type
Content-Type: application/json客户端处理
修正 Content-Type、Content-Encoding 或 body 格式。
易混 / 边界
406 是无法满足响应 Accept;415 是无法处理请求 Content-Type。