# HTTP 状态码

## `1xx` 信息响应

### 100 Continue

HTTP `100 Continue` 信息状态响应代码表示到目前为止一切正常，客户端应继续请求，如果请求已完成，则忽略它。

要让服务器检查请求的标头，客户端必须在其初始请求中发送 `Expect: 100-continue` 作为标头，并在发送正文之前接收 `100 Continue` 状态代码作为响应。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/100](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/100)

### 101 Switching Protocols

HTTP `101 Switching Protocols` 响应代码表示服务器切换到的协议。该协议在从客户端收到的[Upgrade](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Upgrade)请求标头中指定。

服务器在此响应中包含一个[Upgrade](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Upgrade)响应标头，以指示它切换到的协议。

以下文章中描述了该过程：[协议升级机制](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Guides/Protocol_upgrade_mechanism)

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/101](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/101)

### 102 Processing

**已弃用：**此状态代码已弃用。使用时，客户端仍可能接受此响应，但会将其忽略。

HTTP `102 Processing` 信息状态响应代码向客户端指示已收到完整请求并且服务器正在处理该请求。

仅当服务器预计请求需要很长时间时才会发送此状态代码。它告诉客户端您的请求尚未终止。

**来源:** [https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status#102\_processing](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status#102_processing)

### 103 Early Hints

**实验性：**这是一项实验性技术。在生产中使用此功能之前，请仔细检查浏览器兼容性表。

服务器仍在准备响应时，可能会发送 HTTP `103 Early Hints` [信息响应](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status)，并提示服务器期望最终响应将链接的资源。

这使浏览器能够开始[预加载](https://developer.mozilla.org/zh-CN/docs/Web/HTML/Reference/Attributes/rel/preload)资源，而无需等待服务器准备并发送最终响应。

早期提示响应主要用于与 [Link](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Headers/Link) 标头一起使用，该标头指示要加载的资源。

它还可能包含在处理早期提示时强制执行的 [Content-Security-Policy](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Guides/CSP) 标头。

服务器可能会发送多个`103` 响应，例如，在重定向之后。浏览器仅处理第一个早期提示响应，如果请求导致跨源重定向，则必须丢弃该响应。早期提示中预加载的资源实际上被预先添加到 `Document` 的 head 元素中，然后是最终响应中加载的资源。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/103](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/103)

## `2xx` 成功响应

### 200 OK

HTTP `200 OK` 成功状态响应代码表示请求已成功。默认情况下，200 响应是可缓存的。

成功的含义取决于HTTP请求方法：

-   `GET`：资源已获取并在消息正文中传输。
-   `HEAD`：表示标头包含在响应中，没有任何消息正文
-   `POST`：描述操作结果的资源在消息正文中传输
-   `TRACE`：消息正文包含服务器收到的请求消息。

`PUT`或`DELETE`的成功结果往往不是`200 OK`，而是`204 No Content`（或者第一次上传资源时为`201 Created`）。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/200](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/200)

### 201 Created

HTTP `201 Created` 成功状态响应代码表示请求已成功并导致创建资源。

在发送回响应之前，会有效创建新资源或新资源的描述和链接，并且新创建的项目会在消息正文中返回，位于请求的 URL 或 `Location` 标头值中的 URL 处。

此状态码通常用于 `POST` 请求的结果。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/201](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/201)

### 202 Accepted

HTTP `202 Accepted` 响应状态码表示请求已被接受处理，但处理尚未完成；事实上，处理可能尚未开始。

该请求最终可能会或可能不会被执行，因为在实际处理时可能会不允许该请求。

`202` 是非承诺的，这意味着 HTTP 无法稍后发送异步响应来指示处理请求的结果。它适用于另一个进程或服务器处理请求或批处理的情况。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/202](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/202)

### 203 Non-Authoritative Information

HTTP `203 Non-Authoritative Information` 响应状态表明请求已成功，但转换代理修改了源服务器 `200 OK` 响应中的有效负载。

`203` 响应与 `Warning` 标头代码的值 `214`（表示 `Transformation Applied`）类似，具有适用于任何状态代码的响应的额外优点。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/203](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/203)

### 204 No Content

HTTP `204 No Content` 成功状态响应代码表示请求已成功，但客户端不需要离开其当前页面。

例如，在为 wiki 站点实现“保存并继续编辑”功能时可能会使用此代码。在这种情况下，将使用 `PUT` 请求来保存页面，并且将发送 `204 No Content` 响应来指示编辑器不应被其他页面替换。

默认情况下，`204` 响应是可缓存的（此类响应中包含 `ETag` 标头）。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/204](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/204)

### 205 Reset Content

HTTP `205 Reset Content` 响应状态告诉客户端重置文档视图（即清除表单内容、重置画布状态或 UI）。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/205](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/205)

### 206 Partial Content

HTTP `206 Partial Content` 成功状态响应代码表示请求已成功，并且正文包含请求的数据范围，如请求的 Range 标头中所述。

如果只有一个范围，则将整个响应的 `Content-Type` 设置为文档类型，并提供一个 `Content-Range`。

如果发回多个范围，则返回`Content-Type`设置为`multipart/byteranges`，每个片段覆盖一个范围，用`Content-Range`和`Content-Type`描述它。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/206](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/206)

### 207 Multi-Status

HTTP `207 Multi-Status` 响应代码表示可能存在混合响应。

响应正文是带有 `multistatus` 根元素的 `text/xml` 或 `application/xml` HTTP 实体。 XML 正文将列出所有单独的响应代码。

**注意：** 返回资源集合的功能是 WebDAV 协议的一部分（它可以由访问 WebDAV 服务器的 Web 应用程序接收）。浏览器访问网页永远不会遇到这个状态码。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/207](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/207)

### 208 Already Reported

HTTP `208 Already Reported` 响应状态用于 [207 Multi-Status](https://http.cat/status/207) 响应中，以节省空间并避免冲突。如果使用不同的路径多次请求同一资源（例如作为集合的一部分），则仅使用 [200](https://http.cat/status/200) 报告第一个资源。所有其他绑定的响应将使用此 208 状态代码进行报告，因此不会产生冲突并且响应会保持较短。

**注意：**将资源绑定到多个路径的功能是 WebDAV 协议的扩展（它可以由访问 WebDAV 服务器的 Web 应用程序接收）。浏览器访问网页永远不会遇到这个状态码。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/208](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/208)

### 226 IM Used

在增量编码中，HTTP `226 IM Used` 响应状态码表示服务器针对收到的 GET 请求返回了增量数据。IM 是 _Instance Manipulations（实例操作）_ 的缩写，用来描述生成增量数据的算法。

使用增量编码时，服务器对 `GET` 请求返回的是相对于某个基础文档的差异（称为增量），而不是完整的当前文档。客户端通过 HTTP 标头 `A-IM:` 指定要使用的差异算法，通过 `If-None-Match:` 告知服务器最后收到的版本。服务器生成增量，并在状态码为 `226` 的 HTTP 响应中返回。响应还包含 `IM:` 标头（指出所用算法）和 `Delta-Base:` 标头（其 `ETag` 对应于该增量所基于的文档）。

**注意：**浏览器不支持 HTTP 增量编码。此状态码由特定客户端使用的自定义服务器返回。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/226](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/226)

## `3xx` 重定向

### 300 Multiple Choices

HTTP `300 Multiple Choices` 重定向状态响应代码表示该请求有多个可能的响应。

用户代理或用户应该选择其中之一。

由于没有选择响应之一的标准化方法，因此很少使用此响应代码。

如果服务器有首选选择，它应该生成 `Location` 标头。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/300](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/300)

### 301 Moved Permanently

HTTP `301 Moved Permanently` 重定向状态响应代码表示所请求的资源已明确移动到 `Location` 标头给出的 URL。浏览器重定向到新 URL，搜索引擎更新其资源链接。

**注意：**虽然规范要求执行重定向时方法和主体保持不变，但并非所有用户代理都满足此要求。仅使用 301 代码作为 GET 或 HEAD 方法的响应，并使用 308 永久重定向作为 POST 方法，因为此状态明确禁止方法更改。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/301](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/301)

### 302 Found

HTTP `302 Found` 重定向状态响应代码表示请求的资源已暂时移动到 `Location` 标头给出的 URL。浏览器重定向到此页面，但搜索引擎不会更新其到资源的链接（在“SEO 术语”中，据说链接权重不会发送到新的 URL）。

即使规范要求在执行重定向时不得更改方法（和正文），但并非所有用户代理都遵守这一要求，仍有存在缺陷的实现。因此，建议仅将 `302` 代码设置为 `GET` 或 `HEAD` 方法的响应，并改用 `307 Temporary Redirect`，因为在这种情况下明确禁止方法更改。

如果您希望将使用的方法更改为 `GET`，请改用 `303 See Other`。当您想要对 `PUT` 方法做出响应（该方法不是上传的资源而是一条确认消息（例如：“您已成功上传 XYZ”）时，这非常有用。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/302](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/302)

### 303 See Other

HTTP `303 See Other` 重定向状态响应代码表示重定向不会链接到所请求的资源本身，而是链接到另一个页面（例如确认页面，现实世界对象的表示；请参阅 [HTTP range-14](https://en.wikipedia.org/wiki/HTTPRange-14) ；或上传进度页面）。

此响应代码通常作为 `PUT` 的结果发送回来或 `POST`。

用于显示此重定向页面的方法始终是 `GET`。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/303](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/303)

### 304 Not Modified

HTTP `304 Not Modified` 客户端重定向响应码表示无需重传所请求的资源。这是对缓存资源的隐式重定向。当请求方法是安全方法（例如 `GET` 或 `HEAD`）时，或者当请求是有条件的并使用 `If-None-Match` 或 `If-Modified-Since` 标头时，就会发生这种情况。

响应不得包含正文，并且必须包含在等效 `200 OK` 响应中发送的标头： `Cache-Control`、`Content-Location`、`Date`、`ETag`、`Expires` 和 `Vary`。

**注意：** 许多开发者工具的浏览器网络面板会创建导致 304 响应的无关请求，以便开发人员看到对本地缓存的访问。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/304](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/304)

### 305 Use Proxy

**已弃用：**出于安全考虑，HTTP 305 使用代理状态代码已被弃用，许多 HTTP 客户端都会忽略此状态代码。

HTTP 响应状态码 `305 Use Proxy` 是源服务器返回的已弃用的 HTTP 状态码，表示所请求的资源只能通过代理服务器访问。

`305 Use Proxy`状态码用于通知客户端所请求的资源必须通过代理服务器获取，并将该代理地址包含在`Set-Proxy` HTTP标头或`Location` HTTP标头中。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status)

### 306 (Unused)

此状态代码在 HTTP 状态代码注册表中未使用。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status)

### 307 Temporary Redirect

HTTP `307 Temporary Redirect` 重定向状态响应代码表示请求的资源已暂时移动到 `Location` 标头给出的 URL。

原始请求的方法和正文将被重用来执行重定向请求。如果您希望将使用的方法更改为 `GET`，请改用 `303 See Other`。当您想要对 `PUT` 方法给出一个答案，该方法不是上传的资源，而是一条确认消息（例如“您已成功上传 XYZ”）时，这非常有用。

`307` 和 `302` 之间的唯一区别是，`307` 保证在发出重定向请求时，方法和正文不会更改。对于 `302`，一些旧客户端错误地将方法更改为 `GET`：非 GET 方法和 `302` 的行为在 Web 上是不可预测的，而 `307` 的行为是可预测的。对于 `GET` 请求，它们的行为是相同的。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/307](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/307)

### 308 Permanent Redirect

HTTP `308 Permanent Redirect` 重定向状态响应代码表示请求的资源已明确移动到 `Location` 标头给出的 URL。浏览器重定向到此页面，搜索引擎更新其到资源的链接（在“SEO 术语”中，据说链接权重被发送到新的 URL）。

请求方法和正文不会更改，而 `301` 有时可能会错误地更改为 `GET` 方法。

**注意：**某些 Web 应用程序可能会使用308 以非标准方式永久重定向并用于其他目的。例如，Google 云端硬盘使用 308 Resume Incomplete 响应来向客户端指示不完整上传何时停止。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/308](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/308)

## `4xx` 客户端错误

### 400 Bad Request

HTTP `400 Bad Request` 响应状态代码表示服务器由于被认为是客户端错误（例如，格式错误的请求语法、无效的请求消息帧或欺骗性请求路由）而无法或不会处理请求。

**警告：**客户端不应在未经修改的情况下重复此请求。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/400](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/400)

### 401 Unauthorized

HTTP `401 Unauthorized` 响应状态代码表示客户端请求尚未完成，因为缺少所请求资源的有效身份验证凭据。

此状态代码与 HTTP `WWW-Authenticate` 响应标头一起发送，其中包含有关客户端在提示用户输入身份验证凭据后如何再次请求资源的信息。

此状态代码与 `403 Forbidden` 状态代码类似，不同之处在于在某些情况下产生此状态代码后，用户身份验证可以允许访问该资源。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/401](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/401)

### 402 Payment Required

**实验性：**这是一项实验性技术。在生产中使用它之前，请仔细检查浏览器兼容性表。

HTTP `402 Payment Required` 是一个非标准响应状态代码，保留供将来使用。创建此状态代码是为了启用数字现金或（微型）支付系统，并指示在客户付款之前所请求的内容不可用。

有时，此状态代码表示在客户端付款之前无法处理请求。然而，不存在标准的使用约定，不同的实体在不同的上下文中使用它。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/402](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/402)

### 403 Forbidden

HTTP `403 Forbidden` 响应状态代码表示服务器理解该请求，但拒绝授权。

该状态与`401`类似，但对于`403 Forbidden`状态码，重新验证没有区别。访问权限与应用程序逻辑相关，例如对资源的权限不足。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/403](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/403)

### 404 Not Found

HTTP `404 Not Found` 响应状态代码表示服务器找不到所请求的资源。指向 `404` 页面的链接通常称为损坏链接或死链接，并且可能会受到链接腐烂的影响。

`404` 状态代码仅指示资源丢失：而不指示该丢失是暂时的还是永久的。如果资源被永久删除，请改用 `410 Gone` 状态。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/404](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/404)

### 405 Method Not Allowed

HTTP `405 Method Not Allowed` 响应状态码表示服务器知道请求方法，但目标资源不支持该方法。

服务器必须在 `405` 状态代码响应中生成 `Allow` 标头字段。该字段必须包含目标资源当前支持的方法列表。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/405](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/405)

### 406 Not Acceptable

HTTP `406 Not Acceptable` 客户端错误响应代码表示服务器无法生成与请求的主动内容协商标头中定义的可接受值列表相匹配的响应，并且服务器不愿意提供默认表示。

主动内容协商标头包括：

-   `Accept`
-   `Accept-Encoding`
-   `Accept-Language`

实际上，这个错误很少使用。服务器不会使用此错误代码进行响应（这对于最终用户来说是神秘的且难以修复），而是忽略相关标头并向用户提供实际页面。假设即使用户不会完全满意，他们也会更喜欢这个而不是错误代码。

如果服务器返回这样的错误状态，消息正文应包含资源的可用表示形式的列表，允许用户在其中进行选择。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/406](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/406)

### 407 Proxy Authentication Required

HTTP `407 Proxy Authentication Required` 客户端错误状态响应代码表示请求尚未应用，因为它缺少浏览器和可以访问所请求资源的服务器之间的代理服务器的有效身份验证凭据。

此状态与 `Proxy-Authenticate` 标头一起发送，其中包含有关如何正确授权的信息。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/407](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/407)

### 408 Request Timeout

HTTP `408 Request Timeout` 响应状态代码意味着服务器想要关闭此未使用的连接。即使客户端之前没有任何请求，它也会由某些服务器在空闲连接上发送。

服务器应该在响应中发送值为 close 的 `Connection` 标头，因为 `408` 意味着服务器已决定关闭连接而不是继续等待。

由于某些浏览器（例如 Chrome、Firefox 27+ 和 IE9）使用 HTTP 预连接机制来加快速度，因此此响应的使用要多得多。

**注意：**有些服务器只是关闭连接而不发送此消息。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/408](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/408)

### 409 Conflict

HTTP `409 Conflict` 响应状态代码表示请求与目标资源的当前状态冲突。

响应 `PUT` 请求时最有可能发生冲突。例如，上传比服务器上现有文件旧的文件时，您可能会收到 `409` 响应，从而导致版本控制冲突。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/409](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/409)

### 410 Gone

HTTP `410 Gone` 客户端错误响应代码表示源服务器不再提供对目标资源的访问，并且这种情况可能是永久性的。

如果您不知道这种情况是暂时的还是永久的，则应使用 `404` 状态代码。

**注意：**默认情况下，410 响应是可缓存的。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/410](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/410)

### 411 Length Required

HTTP `411 Length Required` 客户端错误响应代码表示服务器拒绝接受没有定义 `Content-Length` 标头的请求。

**注意：**根据规范，当以一系列块发送数据时，Content-Length 标头被省略，并且在每个块的开头需要以十六进制格式添加当前块的长度。有关更多详细信息，请参阅 Transfer-Encoding。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/411](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/411)

### 412 Precondition Failed

HTTP `412 Precondition Failed` 客户端错误响应代码表示对目标资源的访问已被拒绝。当 `If-Unmodified-Since` 或 `If-None-Match` 标头定义的条件未满足时，除 `GET` 或 `HEAD` 之外的方法上的条件请求会发生这种情况。在这种情况下，无法发出请求（通常是上传或修改资源），并且会发回此错误响应。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/412](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/412)

### 413 Content Too Large

HTTP `413 Content Too Large` 响应状态码表示请求实体大于服务器定义的限制；服务器可能会关闭连接或返回 `Retry-After` 标头字段。

在 RFC 9110 之前，状态的响应短语是“Payload Too Large”。该名称至今仍被广泛使用。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/413](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/413)

### 414 URI Too Long

HTTP `414 URI Too Long` 响应状态代码表明客户端请求的 URI 长度超过了服务器愿意解释的长度。

在极少数情况下可能会发生这种情况：

-   当客户端不正确地将 `POST` 请求转换为具有长查询信息的 `GET` 请求时，
-   当客户端陷入重定向循环时（例如，指向其自身后缀的重定向 URI 前缀），
-   或者当服务器受到试图利用潜在安全漏洞的客户端攻击时。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/414](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/414)

### 415 Unsupported Media Type

HTTP `415 Unsupported Media Type` 客户端错误响应代码表示服务器拒绝接受请求，因为负载格式不受支持。

格式问题可能是由于请求指示的 `Content-Type` 或 `Content-Encoding` 造成的，或者是直接检查数据的结果。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/415](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/415)

### 416 Range Not Satisfiable

HTTP `416 Range Not Satisfiable` 错误响应代码表示服务器无法为请求的范围提供服务。最可能的原因是文档不包含此类范围，或者 Range 标头值虽然语法正确，但没有意义。

`416` 响应消息包含指示不满足范围的 `Content-Range`（即 `'*'`），后跟 `'/'` 和资源的当前长度。例如。 `Content-Range: bytes */12777`。

面对此错误，浏览器通常会中止操作（例如，下载将被视为不可恢复）或再次请求整个文档。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/416](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/416)

### 417 Expectation Failed

HTTP `417 Expectation Failed` 客户端错误响应代码表示无法满足请求的 `Expect` 标头中给出的期望。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/417](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/417)

### 418 I'm a Teapot

HTTP `418 I'm a teapot` 客户端错误响应代码表示服务器拒绝冲泡咖啡，因为它永远是一个茶壶。

暂时没有咖啡的组合咖啡/茶壶应返回 503。此错误引用了 1998 年和 2014 年愚人节笑话中定义的超文本咖啡壶控制协议。

某些网站使用此响应来处理他们不希望处理的请求，例如自动查询。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/418](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/418)

### 421 Misdirected Request

HTTP `421 Misdirected Request` 客户端错误响应代码表示请求被定向到无法生成响应的服务器。如果重用连接或选择替代服务，这可能是可能的。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/421](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/421)

### 422 Unprocessable Content

HTTP `422 Unprocessable Content` 响应状态代码表示服务器了解请求实体的内容类型，并且请求实体的语法正确，但无法处理其中包含的指令。

**警告：**客户端不应在未经修改的情况下重复此请求。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/422](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/422)

### 423 Locked

HTTP `423 Locked` 错误响应代码表示请求尝试访问的资源已被锁定，这意味着无法访问它。其内容应包含一些 WebDAV XML 格式的信息。

**注意：**锁定资源的功能特定于某些 WebDAV 服务器。浏览器访问网页永远不会遇到这个状态码；如果发生错误，他们会将其作为通用 400 状态代码进行处理。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/423](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/423)

### 424 Failed Dependency

HTTP `424 Failed Dependency` 客户端错误响应代码表示无法对资源执行该方法，因为请求的操作依赖于另一个操作，并且该操作失败。

常规网络服务器通常不会返回此状态代码。但其他一些协议（例如 WebDAV）可以返回它。例如，在 WebDAV 中，如果发出 `PROPPATCH` 请求，并且一个命令失败，则所有其他命令也会自动失败，并显示 `424 Failed Dependency`。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/424](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/424)

### 425 Too Early

HTTP `425 Too Early` 响应状态代码表示服务器不愿意冒险处理可能重播的请求，这会产生重播攻击的可能性。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/425](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/425)

### 426 Upgrade Required

HTTP `426 Upgrade Required` 客户端错误响应代码表示服务器拒绝使用当前协议执行请求，但在客户端升级到其他协议后可能愿意执行此操作。

服务器会发送带有此响应的 `Upgrade` 标头以指示所需的协议。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/426](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/426)

### 428 Precondition Required

HTTP `428 Precondition Required` 响应状态代码表示服务器要求请求是有条件的。

通常，这意味着缺少必需的前提条件标头，例如 `If-Match`。

当前提条件标头与服务器端状态不匹配时，响应应为 `412 Precondition Failed`。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/428](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/428)

### 429 Too Many Requests

HTTP `429 Too Many Requests` 响应状态代码表示用户在给定时间内发送了太多请求（“速率限制”）。

此响应中可能包含 `Retry-After` 标头，指示在发出新请求之前需要等待多长时间。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/429](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/429)

### 431 Request Header Fields Too Large

HTTP `431 Request Header Fields Too Large` 响应状态代码表示服务器拒绝处理请求，因为请求的 HTTP 标头太长。缩小请求头大小后，可以重新提交请求。

当请求头总大小太大，或者单个头字段太大时，可以使用`431`。为了帮助那些遇到此错误的人，请在响应正文中指出两者中哪一个是问题所在；理想情况下，还包括哪些标头太大。这使用户可以尝试解决问题，例如通过清除 cookie。

如果出现以下情况，服务器通常会生成此状态：

-   `Referer` URL 太长
-   请求中发送的 Cookie 过多

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/431](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/431)

### 451 Unavailable For Legal Reasons

HTTP `451 Unavailable For Legal Reasons` 客户端错误响应代码表示用户请求的资源由于法律原因而不可用，例如已发出法律诉讼的网页。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/451](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/451)

## `5xx` 服务器错误

### 500 Internal Server Error

HTTP `500 Internal Server Error` 服务器错误响应代码表示服务器遇到了意外情况，导致其无法完成请求。

此错误响应是通用的“包罗万象”响应。通常，这表明服务器无法找到更好的 `5xx` 错误代码来响应。有时，服务器管理员会记录错误响应（例如 `500` 状态代码）以及有关请求的更多详细信息，以防止将来再次发生错误。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/500](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/500)

### 501 Not Implemented

HTTP `501 Not Implemented` 服务器错误响应代码意味着服务器不支持完成请求所需的功能。

此状态还可以发送 `Retry-After` 标头，告诉请求者何时检查以查看届时是否支持该功能。

当服务器无法识别请求方法并且无法对任何资源支持该方法时，`501` 是适当的响应。服务器需要支持的唯一方法（因此不得返回 `501`）是 `GET` 和 `HEAD`。

如果服务器确实识别该方法，但故意不支持它，则适当的响应是 `405 Method Not Allowed`。

**注意：** 501 错误通常无法在客户端修复，但需要您尝试访问的 Web 服务器进行修复。

**注意：**默认情况下 501 响应是可缓存的；也就是说，除非缓存标头另有指示。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/501](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/501)

### 502 Bad Gateway

HTTP `502 Bad Gateway` 服务器错误响应代码表示服务器在充当网关或代理时从上游服务器接收到无效响应。

**注意：**网关可能指的是网络中的不同事物，502 错误通常无法在客户端修复，但需要 Web 服务器或您尝试访问的代理进行修复。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/502](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/502)

### 503 Service Unavailable

HTTP `503 Service Unavailable` 服务器错误响应代码表示服务器尚未准备好处理请求。

常见原因是服务器因维护而停机或过载。此响应应用于临时情况，并且 `Retry-After` HTTP 标头应（如果可能）包含服务恢复的估计时间。

应注意随此响应一起发送的与缓存相关的标头，因为 `503` 状态通常是临时条件，通常不应缓存响应。

**注意：**应与此响应一起发送解释问题的用户友好页面。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/503](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/503)

### 504 Gateway Timeout

HTTP `504 Gateway Timeout` 服务器错误响应代码表示服务器在充当网关或代理时没有及时从上游服务器获得完成请求所需的响应。

**注意：**网关可能指的是网络中的不同事物，并且 504 错误通常无法在客户端修复，但需要 Web 服务器或您尝试访问的代理进行修复。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/504](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/504)

### 505 HTTP Version Not Supported

服务器不支持请求使用的 HTTP 版本。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/505](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/505)

### 506 Variant Also Negotiates

HTTP `506 Variant Also Negotiates` 响应状态代码可以在透明内容协商的上下文中给出（请参阅 RFC 2295）。该协议使客户端能够检索给定资源的最佳变体，而服务器支持多种变体。

Variant Also Negotiates 状态码表示内部服务器配置错误，其中所选变体本身配置为参与内容协商，因此不是正确的协商端点。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/506](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/506)

### 507 Insufficient Storage

HTTP `507 Insufficient Storage` 响应状态代码可以在 WebDAV 协议的上下文中给出（请参阅 RFC 4918）。

它表示无法执行某个方法，因为服务器无法存储成功完成请求所需的表示。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/507](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/507)

### 508 Loop Detected

HTTP `508 Loop Detected` 响应状态代码可以在 WebDAV 协议的上下文中给出。

它指示服务器终止操作，因为在处理 `"Depth: infinity"` 请求时遇到无限循环。此状态表明整个操作失败。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/508](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/508)

### 510 Not Extended

HTTP `510 Not Extended` 响应状态代码在 RFC 2774 中定义的 HTTP 扩展框架的上下文中发送。

在该规范中，客户端可以发送包含扩展声明的请求，该声明描述了要使用的扩展。如果服务器收到此类请求，但该请求不支持任何描述的扩展，则服务器会使用 `510` 状态代码进行响应。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/510](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/510)

### 511 Network Authentication Required

HTTP `511 Network Authentication Required` 响应状态代码表示客户端需要进行身份验证才能获得网络访问权限。

此状态不是由源服务器生成的，而是由控制网络访问的拦截代理生成的。

网络运营商有时在授予访问权限之前需要进行一些身份验证、接受条款或其他用户交互（例如在网吧或机场）。他们经常使用媒体访问控制 (MAC) 地址来识别尚未这样做的客户端。

**来源:** [https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/511](https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Reference/Status/511)

MDN 描述由 Mozilla 贡献者编写， [CC BY-SA 2.5](https://creativecommons.org/licenses/by-sa/2.5/),转载自 [HTTP Cats](https://http.cat/).[署名、许可和修改说明](https://200ok.hacks.run/status-description-licenses.txt).
