http常见状态码
文章目录
- 1xx（信息性状态码）
- 2xx（成功状态码）
- 3xx（重定向状态码）
- 4xx（客户端错误状态码）
- 5xx（服务器错误状态码）
- 常见状态码速查
1xx（信息性状态码）
表示请求已被接收，需要继续处理。
- 100 Continue
客户端应继续发送请求的剩余部分（用于大文件上传前确认）。 - 101 Switching Protocols
服务器同意切换协议（如从 HTTP 升级到 WebSocket）。 - 102 Processing（WebDAV）
服务器已收到请求，正在处理，但尚未完成。 - 103 Early Hints
服务器提前返回部分响应头（如 Link 预加载资源），用于优化加载速度。
2xx（成功状态码）
表示请求已成功被服务器接收、理解并处理。
- 200 OK
请求成功，响应中包含请求的数据（如 GET 请求返回页面内容）。 - 201 Created
请求已成功，并创建了新资源（如 POST 请求成功创建数据）。 - 202 Accepted
请求已接受，但尚未处理完成（异步任务常见）。 - 203 Non-Authoritative Information
返回的信息来自非权威源（如代理服务器修改了响应头）。 - 204 No Content
请求成功，但无内容返回（如 DELETE 请求成功但无需返回数据）。
3xx（重定向状态码）
表示需要客户端进一步操作以完成请求（通常是资源位置变化或需要认证）。
- 300 Multiple Choices
多个资源可选（如同一内容有多种格式）。 - 301 Moved Permanently
资源已永久移动到新 URL（搜索引擎会更新索引）。 - 302 Found（原为“临时重定向”）
资源临时移动到新 URL（客户端应继续使用原 URL）。 - 303 See Other
请求结果位于另一个 URL（通常用于 POST 后重定向到 GET）。 - 304 Not Modified
资源未修改（客户端缓存有效，直接使用本地缓存）。
4xx（客户端错误状态码）
表示客户端请求有误，服务器无法处理。
- 400 Bad Request
请求语法错误（如参数缺失、格式错误）。 - 401 Unauthorized
需要身份验证（如未登录或 Token 无效）。 - 402 Payment Required
保留状态码（原计划用于支付场景，实际很少使用）。 - 403 Forbidden
服务器拒绝执行请求（如权限不足）。 - 404 Not Found
请求的资源不存在（如页面或 API 路径错误）。 - 405 Method Not Allowed
请求方法不被支持（如对只读资源使用 POST）。
5xx（服务器错误状态码）
表示服务器在处理请求时发生错误。
- 500 Internal Server Error
服务器内部错误（如代码异常、数据库崩溃）。 - 501 Not Implemented
服务器不支持请求的功能（如未实现的 HTTP 方法）。 - 502 Bad Gateway
网关或代理服务器从上游服务器收到无效响应（如 Nginx 连接后端失败）。 - 503 Service Unavailable
服务器暂时不可用（如维护或过载）。 - 504 Gateway Timeout
网关或代理服务器等待上游服务器响应超时。 - 505 HTTP Version Not Supported
服务器不支持请求的 HTTP 版本（如客户端使用 HTTP/3 但服务器仅支持 HTTP/1.1）。
常见状态码速查
| 状态码 | 含义 | 典型场景 |
|---|---|---|
| 200 | 成功 | 正常返回数据 |
| 301 | 永久重定向 | 网站改版后旧 URL 跳转新 URL |
| 302 | 临时重定向 | 登录后跳转到首页 |
| 304 | 缓存有效 | 浏览器直接加载本地缓存 |
| 400 | 请求错误 | 参数缺失或格式错误 |
| 401 | 未授权 | 未登录或 Token 过期 |
| 403 | 禁止访问 | 权限不足 |
| 404 | 资源不存在 | 访问错误的 URL |
| 405 | 方法不允许 | 对只读资源使用 POST |
| 500 | 服务器错误 | 后端代码崩溃 |
| 502 | 网关错误 | 后端服务不可用 |
| 503 | 服务不可用 | 服务器过载或维护 |