HTTP 状态码查询
按类别整理 1xx 至 5xx 常用状态码,包含标准名称、中文含义与处理建议,支持按状态码或名称实时搜索。
共收录 62 个常用状态码
1xx 信息响应4 个
| 状态码 | 名称 | 含义 | 处理建议 |
|---|---|---|---|
| 100 | Continue | 服务器已收到请求头,客户端可以继续发送请求体。 | 客户端等待 100 响应后再发送正文,无需额外处理。 |
| 101 | Switching Protocols | 服务器根据 Upgrade 请求头切换协议。 | 常见于 WebSocket 升级,检查代理是否透传 Upgrade 头。 |
| 102 | Processing | 服务器已收到并正在处理请求,暂时没有结果(WebDAV)。 | 长耗时任务可返回此码,避免客户端超时断开。 |
| 103 | Early Hints | 在最终响应前提前提示客户端预加载资源。 | 配合 Link 响应头预加载关键资源,缩短首屏时间。 |
2xx 成功10 个
| 状态码 | 名称 | 含义 | 处理建议 |
|---|---|---|---|
| 200 | OK | 请求成功,响应体包含请求的结果。 | 正常返回数据,保持响应结构稳定。 |
| 201 | Created | 请求成功并创建了新的资源。 | 通过 Location 头返回新资源的访问地址。 |
| 202 | Accepted | 请求已被接受,但尚未处理完成。 | 适用于异步任务,返回任务 ID 供后续查询。 |
| 203 | Non-Authoritative Information | 返回的元信息来自副本而非源服务器。 | 一般较少使用,确认是否需要代理改写响应。 |
| 204 | No Content | 请求成功,但没有响应体。 | 常用于删除、更新后无需返回数据的场景。 |
| 205 | Reset Content | 要求客户端重置文档视图。 | 表单提交后可返回此码清空输入。 |
| 206 | Partial Content | 返回资源的部分内容,用于断点续传或分片下载。 | 检查 Range 请求头与 Content-Range 响应头是否正确。 |
| 207 | Multi-Status | 批处理中每个子请求可能返回不同状态(WebDAV)。 | 解析响应体中的各子请求状态,分别处理。 |
| 208 | Already Reported | 同一集合成员已在之前的状态中报告过(WebDAV)。 | 避免重复返回相同的成员信息。 |
| 226 | IM Used | 服务器已完成对资源的增量修改。 | 较少使用,确认客户端是否支持增量更新。 |
3xx 重定向8 个
| 状态码 | 名称 | 含义 | 处理建议 |
|---|---|---|---|
| 300 | Multiple Choices | 请求对应多个可选资源。 | 返回候选列表,由客户端或用户选择目标。 |
| 301 | Moved Permanently | 资源已永久迁移到新的 URL。 | 更新站内链接并使用 301 跳转,传递搜索权重。 |
| 302 | Found | 资源临时位于其他 URL。 | 用于临时跳转,避免长期依赖;注意浏览器可能将 POST 转为 GET。 |
| 303 | See Other | 应使用 GET 访问另一个 URL 获取结果。 | 表单提交后重定向到结果页,避免刷新重复提交。 |
| 304 | Not Modified | 命中协商缓存,资源自上次请求后未变化。 | 检查 ETag / Last-Modified 与 Cache-Control 配置。 |
| 305 | Use Proxy | 必须通过指定代理访问资源(已废弃)。 | 出于安全考虑,不建议使用。 |
| 307 | Temporary Redirect | 临时重定向,且保持原请求方法不变。 | 需要保留 POST 等方法的临时跳转优先使用 307。 |
| 308 | Permanent Redirect | 永久重定向,且保持原请求方法不变。 | 需要保留方法的永久跳转使用 308。 |
4xx 客户端错误29 个
| 状态码 | 名称 | 含义 | 处理建议 |
|---|---|---|---|
| 400 | Bad Request | 请求语法或参数有误,服务器无法理解。 | 校验参数格式、请求体与字符编码,返回明确的错误信息。 |
| 401 | Unauthorized | 缺少或提供了无效的身份凭证。 | 引导用户登录,或携带有效的 Token / Cookie 后重试。 |
| 402 | Payment Required | 保留状态码,多用于需要付费的接口。 | 按业务规则提示用户完成付费或开通。 |
| 403 | Forbidden | 身份已认证,但没有权限访问该资源。 | 检查账号角色、IP 白名单与文件访问权限。 |
| 404 | Not Found | 请求的资源不存在。 | 检查 URL、路由与资源是否被删除,并配置友好的 404 页面。 |
| 405 | Method Not Allowed | 请求方法不被目标资源支持。 | 查看 Allow 响应头,改用正确的 GET / POST 等方法。 |
| 406 | Not Acceptable | 无法满足 Accept 头要求的响应格式。 | 调整 Accept 头,或检查服务端内容协商逻辑。 |
| 407 | Proxy Authentication Required | 需要先通过代理服务器认证。 | 配置正确的代理账号与密码。 |
| 408 | Request Timeout | 客户端未在服务器规定时间内完成请求。 | 检查客户端网络与服务端超时设置。 |
| 409 | Conflict | 请求与资源当前状态冲突,例如重复创建。 | 处理并发与唯一性冲突,返回冲突的具体原因。 |
| 410 | Gone | 资源已被永久删除且不再可用。 | 返回 410 并清理站内链接,比 404 表达更明确。 |
| 411 | Length Required | 请求缺少 Content-Length 头。 | 补全请求头,或改用分块传输。 |
| 412 | Precondition Failed | If-Match 等前置条件不满足。 | 检查 ETag 与并发版本后再重试。 |
| 413 | Content Too Large | 请求体超过服务器允许的大小限制。 | 压缩或分段上传,并合理调整服务端限制。 |
| 414 | URI Too Long | 请求的 URL 长度超过服务器限制。 | 缩短查询参数,或改用 POST 提交数据。 |
| 415 | Unsupported Media Type | 请求体格式不受服务器支持。 | 设置正确的 Content-Type,并确认服务端已支持该格式。 |
| 416 | Range Not Satisfiable | Range 请求的范围超出资源大小。 | 校验 Content-Range 与文件实际长度。 |
| 417 | Expectation Failed | 无法满足 Expect 请求头的要求。 | 移除 Expect 头,或检查中间代理的兼容性。 |
| 418 | I'm a teapot | 愚人节彩蛋状态码(RFC 2324),并非正式业务状态。 | 仅作趣味用途,不要在业务逻辑中使用。 |
| 421 | Misdirected Request | 请求被发送到无法响应的服务器。 | 检查 HTTP/2 连接复用与 SNI 配置。 |
| 422 | Unprocessable Content | 请求语法正确,但语义校验失败。 | 返回字段级的校验错误,便于前端定位。 |
| 423 | Locked | 目标资源被锁定(WebDAV)。 | 解除锁定或等待锁释放后重试。 |
| 424 | Failed Dependency | 因前置请求失败导致当前请求失败(WebDAV)。 | 排查上游依赖与批处理的执行顺序。 |
| 425 | Too Early | 服务器不愿处理可能被重放的早期请求。 | 适当延迟后重试该请求。 |
| 426 | Upgrade Required | 客户端需要升级协议后才能访问资源。 | 按 Upgrade 响应头切换协议,例如升级到 TLS。 |
| 428 | Precondition Required | 服务器要求请求携带前置条件,避免更新丢失。 | 使用 If-Match 等条件请求头。 |
| 429 | Too Many Requests | 请求过于频繁,触发了限流。 | 降低请求频率,并按 Retry-After 提示的时间重试。 |
| 431 | Request Header Fields Too Large | 请求头总长度超过服务器限制。 | 精简 Cookie 与自定义请求头,或增大限制。 |
| 451 | Unavailable For Legal Reasons | 因法律要求无法提供该资源。 | 说明不可用的原因,并按合规要求处理。 |
5xx 服务器错误11 个
| 状态码 | 名称 | 含义 | 处理建议 |
|---|---|---|---|
| 500 | Internal Server Error | 服务器处理请求时发生未预期的错误。 | 查看服务端日志与异常堆栈,修复后发布;对外返回友好提示。 |
| 501 | Not Implemented | 服务器不支持该请求方法。 | 实现对应方法,或改为返回 405 并给出 Allow 头。 |
| 502 | Bad Gateway | 网关或代理从上游服务收到无效响应。 | 检查上游服务状态、反向代理配置与连接超时。 |
| 503 | Service Unavailable | 服务器暂时无法处理请求,通常是过载或维护。 | 返回 Retry-After,扩容实例或等待维护完成。 |
| 504 | Gateway Timeout | 网关等待上游服务响应超时。 | 检查上游性能、慢查询与代理超时设置。 |
| 505 | HTTP Version Not Supported | 服务器不支持请求使用的 HTTP 版本。 | 改用受支持的 HTTP 版本发起请求。 |
| 506 | Variant Also Negotiates | 内容协商配置错误,导致变体之间循环协商。 | 检查服务端的内容协商配置。 |
| 507 | Insufficient Storage | 服务器无法存储完成请求所需的内容(WebDAV)。 | 清理或扩容存储空间后重试。 |
| 508 | Loop Detected | 服务器检测到处理过程中的无限循环(WebDAV)。 | 检查目录链接与重定向链路。 |
| 510 | Not Extended | 需要对请求进行进一步扩展才能完成。 | 检查扩展协议与相关配置。 |
| 511 | Network Authentication Required | 客户端需要完成网络认证,例如公共 WiFi 登录。 | 完成网络认证后重新访问。 |
状态码由三位数字组成:第一位表示响应类别,后两位用于区分具体语义。RFC 9110 将 1xx 至 5xx 定义为标准类别,部分状态码来自 WebDAV 等扩展规范;排查线上问题时,应结合响应体、日志与服务端配置综合判断。