HTTP 状态码分为五大类,分别是1xx(信息响应)、2xx(成功)、3xx(重定向)、4xx(客户端错误)、5xx(服务器错误)。以下是常见的 HTTP 状态码及其含义的完整列表:
1xx 信息响应
状态码 | 描述 | 含义 |
---|---|---|
100 | Continue | 请求的初始部分已接收,客户端可以继续发送其余部分。 |
101 | Switching Protocols | 服务器已同意切换协议,例如从 HTTP 升级到 WebSocket。 |
102 | Processing (WebDAV) | 服务器已接收到请求,正在处理但尚未完成响应。 |
2xx 成功
状态码 | 描述 | 含义 |
---|---|---|
200 | OK | 请求成功,服务器返回所请求的资源。 |
201 | Created | 请求成功并在服务器创建了新的资源。 |
202 | Accepted | 请求已接收但尚未处理完成(异步处理)。 |
203 | Non-Authoritative Information | 返回的元信息不是服务器的原始数据,而是经过变动的。 |
204 | No Content | 请求成功,但没有返回内容(通常用于删除操作)。 |
205 | Reset Content | 请求成功,需要客户端重置视图。 |
206 | Partial Content | 返回部分内容,用于分块下载(例如文件分片)。 |
207 | Multi-Status (WebDAV) | 服务器返回多个操作结果的状态(多状态响应)。 |
3xx 重定向
状态码 | 描述 | 含义 |
---|---|---|
300 | Multiple Choices | 请求有多个可能的响应,客户端需选择。 |
301 | Moved Permanently | 资源已永久移动到新位置,需使用新 URL。 |
302 | Found | 临时重定向到新位置,未来仍需使用旧 URL。 |
303 | See Other | 重定向到另一个 URL(推荐使用 GET 方法访问)。 |
304 | Not Modified | 资源未被修改,可使用缓存。 |
305 | Use Proxy | 请求需要通过代理访问。 |
307 | Temporary Redirect | 临时重定向(方法保持不变)。 |
308 | Permanent Redirect | 永久重定向(方法保持不变)。 |
4xx 客户端错误
状态码 | 描述 | 含义 |
---|---|---|
400 | Bad Request | 请求无效,可能有语法错误。 |
401 | Unauthorized | 未授权,需提供认证信息。 |
403 | Forbidden | 服务器拒绝请求,客户端无权访问。 |
404 | Not Found | 请求的资源不存在。 |
405 | Method Not Allowed | 请求的方法被禁用,例如 POST 请求到只接受 GET 的接口。 |
406 | Not Acceptable | 请求的资源不符合客户端的期望格式。 |
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 | (愚人节彩蛋)服务器拒绝冲泡咖啡(玩笑代码)。 |
422 | Unprocessable Entity | 请求格式正确但无法处理(例如表单验证失败)。 |
425 | Too Early | 服务器不愿处理可能重复的请求。 |
426 | Upgrade Required | 客户端需切换到更高级的协议(如 HTTPS)。 |
429 | Too Many Requests | 客户端发送了太多请求(通常用于速率限制)。 |
5xx 服务器错误
状态码 | 描述 | 含义 |
---|---|---|
500 | Internal Server Error | 服务器遇到未知错误。 |
501 | Not Implemented | 请求方法未被支持。 |
502 | Bad Gateway | 网关或代理收到无效响应。 |
503 | Service Unavailable | 服务器不可用,通常用于维护或过载。 |
504 | Gateway Timeout | 网关或代理超时。 |
505 | HTTP Version Not Supported | 不支持的 HTTP 版本。 |
507 | Insufficient Storage | 服务器存储空间不足(WebDAV)。 |
508 | Loop Detected | 请求导致服务器进入无限循环(WebDAV)。 |
511 | Network Authentication Required | 需要进行网络认证(例如登录 Wi-Fi 门户)。 |