HTTP状态码速查

文档说明

HTTP 状态码是服务器在响应客户端请求时返回的三位数字代码，用于表示请求的处理状态。它们分为五类，首位数字定义了响应的类别。

1xx - 信息性响应

表示请求已被接收，需要继续处理。

• 100 Continue: 等待客户端发送请求的正文部分。
• 101 Switching Protocols: 服务器已同意切换协议。
• 102 Processing: 服务器正在处理请求，但尚未有可用的响应（用于 WebDAV）。
• 103 Early Hints: 服务器在最终的 HTTP 消息之前返回一些响应头。

2xx - 成功

表示请求已成功被服务器接收、理解并接受。

• 200 OK: 标准成功响应，表示请求已成功处理。
• 201 Created: 请求已成功，并因此创建了一个新的资源。
• 202 Accepted: 服务器已接受请求进行处理，但处理尚未完成。
• 203 Non-Authoritative Information: 请求成功，但返回的实体头部的元信息并非来自原始服务器，而可能来自本地或第三方副本。
• 204 No Content: 服务器成功处理了请求，但不会返回任何内容主体。
• 205 Reset Content: 服务器提示发送此请求的客户端应重置当前文档视图。
• 206 Partial Content: 由于客户端发送了范围请求头，服务器只返回了部分资源。
• 207 Multi-Status: 后续的消息体是一个XML消息，可能包含多个独立的响应代码（用于 WebDAV）。
• 208 Already Reported: DAV 绑定的成员已在先前部分的多状态响应中被枚举（用于 WebDAV）。
• 226 IM Used: 服务器已经完成了对资源的请求，响应是操作结果的表示。

3xx - 重定向

表示需要客户端采取进一步的操作才能完成请求，通常需要重定向到另一个URL。

• 300 Multiple Choices: 表示客户端请求的资源有多个选择，每个选择都有自己的特定地址。
• 301 Moved Permanently: 请求的资源已被永久移动到新的 URI，今后应使用新的 URI。
• 302 Found: 请求的资源临时移动到另一个 URI 上，客户端应继续使用原始 URI。
• 303 See Other: 对当前请求的响应可以在另一个 URI 上找到，客户端应该使用 GET 方法获取资源。
• 304 Not Modified: 所请求的资源自上次请求后未被修改，客户端可以使用缓存的版本。
• 305 Use Proxy: 请求的资源必须通过代理访问，代理的位置在 Location 头部中给出。
• 306 Switch Proxy: 已不再使用，最初表示“后续请求应使用指定的代理”。
• 307 Temporary Redirect: 请求的资源临时位于另一个 URI，请求应使用原请求方法重复发往该 URI。
• 308 Permanent Redirect: 请求的资源已永久移动到另一个 URI，当前以及所有未来的请求都应使用新的 URI。

4xx - 客户端错误

表示客户端的请求有错误，服务器无法处理。

• 400 Bad Request: 由于存在语法错误、参数不正确等明显的客户端错误，服务器无法或不会处理该请求。
• 401 Unauthorized: 请求需要用户认证或认证失败。
• 402 Payment Required: 为将来使用而保留，最初意图是可能用于数字现金或小额支付系统。
• 403 Forbidden: 请求有效，但服务器拒绝执行。用户可能没有访问该资源所需的权限。
• 404 Not Found: 服务器找不到请求的资源。
• 405 Method Not Allowed: 请求中使用的 HTTP 方法不被目标资源支持。
• 406 Not Acceptable: 服务器无法根据客户端请求头中的条件（如 Accept 头）生成相应的内容。
• 407 Proxy Authentication Required: 客户端必须首先通过代理服务器的身份验证。
• 408 Request Timeout: 服务器在等待客户端发送请求时超时。
• 409 Conflict: 请求无法处理，因为与请求的当前状态存在冲突（例如编辑冲突）。
• 410 Gone: 请求的资源已永久删除且不可恢复。
• 411 Length Required: 服务器拒绝处理没有包含 Content-Length 头部的请求。
• 412 Precondition Failed: 服务器不满足请求者在请求中设置的某个前提条件。
• 413 Payload Too Large: 请求的实体数据过大，服务器无法或不愿意处理。
• 414 URI Too Long: 请求的 URI 过长，服务器无法处理。
• 415 Unsupported Media Type: 请求的媒体格式不被服务器或资源支持。
• 416 Range Not Satisfiable: 客户端请求了资源的某个部分，但服务器无法提供该部分。
• 417 Expectation Failed: 服务器无法满足 Expect 请求头字段的期望值。
• 418 I’m a teapot: 服务器拒绝尝试用茶壶煮咖啡（来自愚人节笑话RFC）。
• 421 Misdirected Request: 请求被发送到一个无法产生响应的服务器。
• 422 Unprocessable Entity: 请求格式正确，但由于存在语义错误无法被处理。
• 423 Locked: 所要访问的资源当前已被锁定。
• 424 Failed Dependency: 由于之前的某个请求失败，导致当前请求失败。
• 425 Too Early: 服务器不愿意冒险处理一个可能被重放的请求。
• 426 Upgrade Required: 客户端应升级到其他协议，例如 TLS/1.0。
• 428 Precondition Required: 原始服务器要求请求是有条件的。
• 429 Too Many Requests: 客户端在给定的时间内发送了过多的请求。
• 431 Request Header Fields Too Large: 由于单个头字段或所有头字段集体过大，服务器拒绝处理请求。
• 451 Unavailable For Legal Reasons: 由于法律原因，服务器运营商拒绝访问某个资源或一组资源。

5xx - 服务器错误

表示服务器在处理请求的过程中发生了错误。

• 500 Internal Server Error: 服务器遇到了一个未曾预料的情况，导致它无法完成请求处理。
• 501 Not Implemented: 服务器不支持实现请求所需的功能。
• 502 Bad Gateway: 服务器作为网关或代理时，从上游服务器收到了一个无效的响应。
• 503 Service Unavailable: 服务器由于超载或系统维护，当前无法处理请求（通常是临时状态）。
• 504 Gateway Timeout: 服务器作为网关或代理时，未能及时从上游服务器收到响应。
• 505 HTTP Version Not Supported: 服务器不支持请求中所用的 HTTP 协议版本。
• 506 Variant Also Negotiates: 服务器存在内部配置错误，透明内容协商导致循环引用。
• 507 Insufficient Storage: 服务器无法存储完成请求所需的表示（用于 WebDAV）。
• 508 Loop Detected: 服务器在处理请求时检测到无限循环（用于 WebDAV）。
• 510 Not Extended: 需要对请求进行进一步扩展，服务器才能完成处理。
• 511 Network Authentication Required: 客户端需要进行网络认证才能获得网络访问权限（常见于需认证门户）。

---