HTTP 状态码

HTTP 状态码速查表,含义与使用场景

59 个状态码
1xx 信息响应
状态码名称含义与使用场景
100Continue继续。客户端应继续发送请求的剩余部分
101Switching Protocols切换协议。服务器同意切换协议(如升级到 WebSocket)
102Processing处理中。服务器已收到请求,正在处理(WebDAV)
103Early Hints早期提示。用于在最终响应前预加载资源
2xx 成功
状态码名称含义与使用场景
200OK成功。请求已成功处理,响应体包含请求的数据
201Created已创建。资源已成功创建,常用于 POST 请求
202Accepted已接受。请求已接收但未处理完成(异步任务)
203Non-Authoritative Information非权威信息。返回的信息来自第三方副本
204No Content无内容。成功但无响应体返回(如 DELETE 后)
205Reset Content重置内容。要求客户端重置表单
206Partial Content部分内容。范围请求成功(断点续传)
207Multi-Status多状态。XML 返回多个操作的独立状态(WebDAV)
3xx 重定向
状态码名称含义与使用场景
300Multiple Choices多选。资源有多个表示,需选择其一
301Moved Permanently永久重定向。资源已永久迁移到新 URL
302Found临时重定向。资源临时位于其他 URL
303See Other查看其他。用 GET 访问另一个 URL 获取结果
304Not Modified未修改。缓存仍有效,无需重新下载
307Temporary Redirect临时重定向。保持原请求方法和 URL 不变
308Permanent Redirect永久重定向。保持请求方法的永久跳转
4xx 客户端错误
状态码名称含义与使用场景
400Bad Request请求错误。服务器无法理解请求格式
401Unauthorized未授权。需要身份验证才能访问
402Payment Required需要付款。保留用于将来付费机制
403Forbidden禁止访问。已认证但无权限访问该资源
404Not Found未找到。请求的资源不存在
405Method Not Allowed方法不允许。该 URL 不支持此 HTTP 方法
406Not Acceptable不可接受。无法生成客户端可接受的内容
407Proxy Authentication Required需要代理认证。需先向代理验证身份
408Request Timeout请求超时。客户端未在规定时间内发送请求
409Conflict冲突。请求与服务器当前状态冲突
410Gone已消失。资源已永久删除且无新地址
411Length Required需要长度。必须提供 Content-Length 头
412Precondition Failed前置条件失败。条件请求未满足
413Payload Too Large请求体过大。超出服务器限制
414URI Too LongURI 过长。URL 超出服务器处理能力
415Unsupported Media Type不支持的媒体类型。Content-Type 不被接受
416Range Not Satisfiable范围无法满足。请求的 byte 范围无效
417Expectation Failed期望失败。Expect 头无法满足
418I'm a Teapot我是茶壶。愚人节彩蛋,不能用来泡咖啡
421Misdirected Request请求误导。请求发到了无法响应的服务器
422Unprocessable Entity不可处理实体。语法正确但语义错误(校验失败)
423Locked已锁定。资源被锁定(WebDAV)
424Failed Dependency依赖失败。依赖的请求失败(WebDAV)
425Too Early过早。服务器不愿冒重放风险处理请求
426Upgrade Required需要升级。客户端需切换协议
428Precondition Required需要前置条件。要求提供 If-Match 等条件头
429Too Many Requests请求过多。触发限流,请稍后重试
431Request Header Fields Too Large请求头过大。头字段超出限制
451Unavailable For Legal Reasons因法律原因不可用。常用于内容审查
5xx 服务端错误
状态码名称含义与使用场景
500Internal Server Error服务器内部错误。通用服务端异常
501Not Implemented未实现。服务器不支持该请求方法
502Bad Gateway网关错误。上游服务器返回无效响应
503Service Unavailable服务不可用。服务器过载或维护中
504Gateway Timeout网关超时。上游服务器响应超时
505HTTP Version Not Supported不支持该 HTTP 版本
506Variant Also Negotiates变体也参与协商。内容协商配置错误
507Insufficient Storage存储不足。服务器无法存储(WebDAV)
508Loop Detected检测到循环。处理请求时陷入无限循环(WebDAV)
510Not Extended未扩展。需要进一步扩展才能处理
511Network Authentication Required需要网络认证。需登录网络(如公共 WiFi)