HTTP 响应状态码

admin 2026-08-03 18:53:26

400 Bad Request

由于被认为是客户端错误(例如,格式错误的请求语法、无效的请求消息帧或欺骗性请求路由),服务器无法或不会处理请求。

401 Unauthorized

尽管 HTTP 标准规定“未经授权”,但语义上此响应表示“未经身份验证”。也就是说,客户端必须自行进行身份验证才能获取请求的响应。

402 Payment Required

此代码的最初目的是用于数字支付系统,但是此状态码很少使用,并且没有标准约定。

403 Forbidden

客户端无权访问内容;也就是说,它未经授权,因此服务器拒绝提供请求的资源。与 401 Unauthorized 不同,客户端的身份服务器已知。

404 Not Found

服务器找不到请求的资源。在浏览器中,这意味着 URL 未被识别。在 API 中,这也可以意味着端点有效但资源本身不存在。服务器也可能发送此响应而不是 403 Forbidden 以隐藏未经授权的客户端的资源存在。由于其在网络上频繁出现,此响应代码可能是最著名的。

405 Method Not Allowed

服务器已知 请求方法,但目标资源不支持。例如,API 可能不允许对资源进行 DELETE,或者完全不允许 TRACE 方法。

406 Not Acceptable

此响应是在 Web 服务器执行 服务器驱动的内容协商 后,没有找到任何符合用户代理给定条件的内容时发送的。

407 Proxy Authentication Required

这类似于 401 Unauthorized,但需要通过代理进行身份验证。

408 Request Timeout

此响应由某些服务器在空闲连接上发送,即使客户端之前没有任何请求。这意味着服务器希望关闭此未使用的连接。由于一些浏览器使用 HTTP 预连接机制来加速浏览,因此此响应的使用频率更高。一些服务器可能会在不发送此消息的情况下关闭连接。

409 Conflict

当请求与服务器的当前状态冲突时,会发送此响应。在 WebDAV 远程 Web 创作中,409 响应是发送给客户端的错误,以便用户可以解决冲突并重新提交请求。

410 Gone

当请求的内容已从服务器永久删除,且没有转发地址时,会发送此响应。客户端应删除其缓存和指向资源的链接。HTTP 规范旨在将此状态码用于“限时、促销服务”。API 不应觉得有必要使用此状态码来指示已删除的资源。

411 Length Required

服务器拒绝请求,因为未定义 Content-Length 头部字段,并且服务器需要它。

412 Precondition Failed

在 条件请求 中,客户端在其头部中指出了服务器不满足的先决条件。

413 Content Too Large

请求正文大于服务器定义的限制。服务器可能会关闭连接或返回 Retry-After 头部字段。

414 URI Too Long

客户端请求的 URI 长度超过服务器愿意解释的长度。

415 Unsupported Media Type

服务器不支持请求数据的媒体格式,因此服务器拒绝请求。

416 Range Not Satisfiable

请求中 Range 头部字段指定的 范围 无法满足。范围可能超出了目标资源数据的大小。

417 Expectation Failed

此响应代码表示服务器无法满足 Expect 请求头部字段指示的期望。

418 I'm a teapot

服务器拒绝尝试用茶壶冲泡咖啡。

421 Misdirected Request

请求指向了一个无法生成响应的服务器。这可能由一个未配置为为请求 URI 中包含的方案和权限组合生成响应的服务器发送。

422 Unprocessable Content (WebDAV)

请求格式正确,但由于语义错误而无法执行。

423 Locked (WebDAV)

正在访问的资源被锁定。

424 Failed Dependency (WebDAV)

请求失败是由于先前的请求失败。

425 Too Early 实验性

表示服务器不愿意冒险处理可能被重放的请求。

426 Upgrade Required

服务器拒绝使用当前协议执行请求,但客户端升级到不同协议后可能愿意这样做。服务器在 426 响应中发送 Upgrade 头部以指示所需的协议。

428 Precondition Required

源服务器要求请求是 条件性的。此响应旨在防止“丢失更新”问题,即客户端 GET 资源的 상태,修改它并将其 PUT 回服务器,而同时第三方已修改服务器上的状态,导致冲突。

429 Too Many Requests

用户在给定时间内发送了太多请求(速率限制)。

431 Request Header Fields Too Large

服务器不愿意处理请求,因为其头部字段过大。在减小请求头部字段的大小后,请求可以重新提交。

451 Unavailable For Legal Reasons

用户代理请求了一个无法合法提供的资源,例如被政府审查的网页。