HTTP状态码http-status
HTTP状态码速查表,涵盖1xx-5xx全部常见状态码的含义与使用场景说明。
| 状态码 | 名称 | 说明 |
|---|---|---|
| 1xx 信息响应 | ||
| 100 | Continue | 服务器已收到请求头,客户端可继续发送请求体 |
| 101 | Switching Protocols | 协议切换,如升级到 WebSocket |
| 2xx 成功 | ||
| 200 | OK | 请求成功,最常见的成功状态 |
| 201 | Created | 资源创建成功,常见于 POST 新建 |
| 202 | Accepted | 请求已接受,但尚未处理完成(异步任务) |
| 204 | No Content | 成功但无返回内容,常见于删除操作 |
| 206 | Partial Content | 范围请求成功,用于断点续传与视频播放 |
| 3xx 重定向 | ||
| 301 | Moved Permanently | 永久重定向,SEO 权重会转移到新地址 |
| 302 | Found | 临时重定向,搜索引擎保留原地址 |
| 303 | See Other | 要求用 GET 方法访问另一地址 |
| 304 | Not Modified | 资源未修改,直接使用浏览器缓存 |
| 307 | Temporary Redirect | 临时重定向,且不允许改变请求方法 |
| 308 | Permanent Redirect | 永久重定向,且不允许改变请求方法 |
| 4xx 客户端错误 | ||
| 400 | Bad Request | 请求格式错误,服务器无法理解 |
| 401 | Unauthorized | 未认证,需要登录或提供有效凭证 |
| 403 | Forbidden | 已认证但无权限访问该资源 |
| 404 | Not Found | 资源不存在,最著名的状态码 |
| 405 | Method Not Allowed | 请求方法不被允许,如对只读接口 POST |
| 408 | Request Timeout | 请求超时,服务器等待客户端过久 |
| 409 | Conflict | 请求与资源当前状态冲突,如重复提交 |
| 410 | Gone | 资源已被永久删除,比404语义更明确 |
| 413 | Payload Too Large | 请求体过大,常见于上传超限 |
| 415 | Unsupported Media Type | 不支持的内容类型,如 Content-Type 错误 |
| 418 | I'm a teapot | 愚人节彩蛋状态码:茶壶拒绝煮咖啡 |
| 422 | Unprocessable Entity | 语法正确但语义校验失败,常见于表单验证 |
| 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 版本 |