qktools

HTTP 状态码参考

100% 本地处理
  • 100

    Continue

    服务器已收到请求头,客户端应继续发送请求体。

  • 101

    Switching Protocols

    服务器应客户端请求切换协议(如升级到 WebSocket)。

  • 102

    Processing

    服务器已收到并正在处理请求,但尚无响应可返回(WebDAV)。

  • 103

    Early Hints

    在最终响应前提前返回部分头部,便于浏览器预加载资源。

  • 200

    OK

    请求成功,响应中包含所请求的数据。

  • 201

    Created

    请求成功且服务器创建了新资源。

  • 202

    Accepted

    请求已接受,但尚未处理完成(异步处理)。

  • 203

    Non-Authoritative Information

    返回的元信息来自第三方副本,非源服务器。

  • 204

    No Content

    请求成功,但没有响应体内容。

  • 205

    Reset Content

    请求成功,要求客户端重置当前页面视图(如清空表单)。

  • 206

    Partial Content

    服务器成功返回了部分内容(用于断点续传、分段下载)。

  • 207

    Multi-Status

    多状态响应,主体包含多个资源各自的状态(WebDAV)。

  • 208

    Already Reported

    绑定成员已在前面枚举过,不再重复列出(WebDAV)。

  • 226

    IM Used

    服务器已完成对资源的实例操作并返回结果。

  • 300

    Multiple Choices

    请求的资源有多个可选表示,需客户端选择其一。

  • 301

    Moved Permanently

    资源已永久移动到新地址,后续请求应使用新 URL。

  • 302

    Found

    资源临时位于另一地址,后续仍使用原 URL。

  • 303

    See Other

    应使用 GET 方法访问另一地址获取结果(常见于表单提交后)。

  • 304

    Not Modified

    资源未修改,可直接使用本地缓存。

  • 307

    Temporary Redirect

    资源临时重定向,且必须保持原请求方法不变。

  • 308

    Permanent Redirect

    资源永久重定向,且必须保持原请求方法不变。

  • 400

    Bad Request

    请求语法错误或参数无效,服务器无法理解。

  • 401

    Unauthorized

    需要身份认证,请提供有效的登录凭据。

  • 402

    Payment Required

    为将来付费场景预留,目前很少使用。

  • 403

    Forbidden

    服务器理解请求但拒绝执行,权限不足。

  • 404

    Not Found

    找不到请求的资源,地址可能有误或已被删除。

  • 405

    Method Not Allowed

    请求方法不被该资源允许(如对只读接口用 POST)。

  • 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

    我是茶壶,无法煮咖啡——一个愚人节玩笑式状态码。

  • 421

    Misdirected Request

    请求被发往无法对其生成响应的服务器。

  • 422

    Unprocessable Entity

    请求格式正确但语义有误,无法处理(常见于校验失败)。

  • 423

    Locked

    目标资源被锁定,暂时无法操作(WebDAV)。

  • 424

    Failed Dependency

    因依赖的前置请求失败,当前请求也随之失败(WebDAV)。

  • 425

    Too Early

    服务器不愿处理可能被重放的请求。

  • 426

    Upgrade Required

    客户端需升级到其他协议才能继续。

  • 428

    Precondition Required

    要求请求附带前置条件,以避免冲突更新。

  • 429

    Too Many Requests

    请求过于频繁,已触发限流,请稍后再试。

  • 431

    Request Header Fields Too Large

    请求头字段过大,服务器拒绝处理。

  • 451

    Unavailable For Legal Reasons

    因法律原因,该资源不可访问。

  • 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

    需要先通过网络认证才能访问(如连接公共 Wi-Fi)。

常见问题

按首位数字分五类:1xx 信息(请求已收到、继续处理)、2xx 成功、3xx 重定向、4xx 客户端错误(请求有问题)、5xx 服务端错误(服务器处理失败)。