继续

Continue

服务器已收到请求头，客户端可以继续发送请求体。

切换协议

Switching Protocols

服务器同意客户端升级协议的请求，例如切换到 WebSocket。

处理中

Processing

服务器正在处理请求，但尚未返回最终响应（WebDAV）。

早期提示

Early Hints

服务器先发送部分响应头，提示浏览器预加载资源以加快首屏。

请求成功

OK

请求成功；响应内容取决于请求方法，HEAD 响应不包含消息体。

已创建

Created

请求成功且资源已创建，常见于 POST 提交后。

提示：通常配合 Location 头返回新资源地址。

已接受

Accepted

服务器已接受请求，但处理可能尚未完成。

非权威信息

Non-Authoritative Information

请求成功，但响应内容经过转换代理修改，与源服务器的 200 响应不同。

无内容

No Content

请求成功，但响应体没有内容可返回。

提示：删除操作、接口心跳检测常返回 204。

重置内容

Reset Content

请求成功，同时要求客户端重置表单等页面视图。

部分内容

Partial Content

响应了 Range 请求中指定的数据片段，用于断点续传与视频流。

多状态

Multi-Status

一次返回多个独立操作的执行状态（WebDAV）。

多种选择

Multiple Choices

请求对应多个可用表示，需要客户端自行选择。

永久移动

Moved Permanently

资源已永久迁移到新的 URL。

提示：搜索引擎会更新收录；需要保留旧链接时请返回 301。

临时移动

Found

资源临时位于其他 URL，后续请求应继续使用原地址。

查看其他位置

See Other

应使用 GET 请求访问 Location 指定的地址，常见于表单提交后的跳转。

未修改

Not Modified

资源自上次请求后未变化，客户端可直接使用本地缓存。

临时重定向

Temporary Redirect

与 302 类似，但重定向时保留原请求方法与请求体。

永久重定向

Permanent Redirect

与 301 类似，但重定向时保留原请求方法，不能把 POST 改成 GET。

请求错误

Bad Request

请求语法或参数有误，服务器无法理解。

提示：检查参数格式、编码与请求头是否符合接口约定。

未认证

Unauthorized

请求缺少身份凭证或凭证无效。

提示：检查是否携带了正确的 Token 或登录态。

需要付费

Payment Required

预留状态码，用于需要支付后才能访问的场景。

禁止访问

Forbidden

服务器理解请求但拒绝执行，通常因权限不足。

提示：确认账号是否具备该资源的访问权限。

资源不存在

Not Found

请求的路径在服务器上不存在。

提示：检查 URL 是否拼写正确，或页面是否已下线。

方法不允许

Method Not Allowed

请求方法不被该接口支持，例如对只读接口发送 POST。

提示：检查接口文档中允许的方法，并核对 Allow 响应头。

无法满足

Not Acceptable

服务器无法按 Accept 头的要求返回内容类型。

需要代理认证

Proxy Authentication Required

访问代理服务器时需要提供身份认证。

请求超时

Request Timeout

服务器等待客户端发送请求超时，连接被关闭。

冲突

Conflict

请求与服务器当前状态冲突，例如版本不一致的并发更新。

已删除

Gone

资源曾被提供但现已永久删除，且不会再恢复。

缺少长度

Length Required

请求缺少 Content-Length 头，服务器无法确定请求体大小。

前置条件不满足

Precondition Failed

请求头中的前置条件（如 If-Match）校验失败。

请求体过大

Content Too Large

请求体超过服务器允许的上限。

提示：可尝试压缩内容或分片上传。

URL 过长

URI Too Long

请求的 URI 超过服务器可处理长度。

不支持的媒体类型

Unsupported Media Type

请求体的 Content-Type 不是服务器支持的类型。

范围无法满足

Range Not Satisfiable

Range 头请求的范围超出资源实际大小。

预期失败

Expectation Failed

Expect 请求头中的预期无法被服务器满足。

无法处理

Unprocessable Content

请求格式正确但内容存在语义错误，常见于表单校验失败。

提示：查看响应体中的错误详情，修正字段后重试。

已锁定

Locked

目标资源被锁定，无法执行请求操作（WebDAV）。

保留未使用

Unused

RFC 9110 将此状态码保留；历史上以 I’m a teapot 为人熟知，不宜用于常规业务错误。

请求目标错误

Misdirected Request

请求被发送到了无法为目标 URI 提供权威响应的服务器。

依赖失败

Failed Dependency

当前操作依赖的另一项操作失败（WebDAV）。

请求过早

Too Early

服务器担心请求来自尚不安全的重放连接，拒绝处理。

需要升级协议

Upgrade Required

客户端需要使用其他协议（如 TLS）才能继续访问。

需要前置条件

Precondition Required

服务器要求请求携带 If-Match 等前置条件以避免竞态。

请求过于频繁

Too Many Requests

客户端在限定时间内发送了过多请求，已被限流。

提示：根据 Retry-After 头的时间间隔后再重试。

请求头过大

Request Header Fields Too Large

请求头整体超过服务器允许的大小（如 Cookie 过大）。

因法律不可用

Unavailable For Legal Reasons

资源因法律原因在服务器所在地不可访问。

服务器内部错误

Internal Server Error

服务器内部发生未预期的异常，无法完成请求。

提示：查看服务端日志定位异常堆栈，避免向客户端泄露细节。

未实现

Not Implemented

服务器不支持请求所需的功能。

网关错误

Bad Gateway

网关或代理从上游服务器收到无效响应。

提示：检查后端服务是否存活、是否超时，网关配置是否正常。

服务不可用

Service Unavailable

服务器暂时无法处理请求，可能处于过载或维护状态。

提示：结合 Retry-After 头告知客户端何时可以重试。

网关超时

Gateway Timeout

网关在等待上游服务器响应时超时。

提示：排查上游接口的耗时与网关的超时配置。

HTTP 版本不支持

HTTP Version Not Supported

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

存储不足

Insufficient Storage

服务器存储空间不足，无法完成请求（WebDAV）。

检测到循环

Loop Detected

请求处理过程中检测到无限循环（WebDAV）。

需要网络认证

Network Authentication Required

客户端需要先完成网络认证（如连接 Wi-Fi 登录页）。