http-status-reference
| 状态码 | 名称 | 说明 | 典型场景 |
|---|---|---|---|
| Continue | 客户端应继续其请求 | 大文件上传前先发请求检查，服务器返回 100 后继续传输 | |
| Switching Protocols | 服务器同意切换协议 | WebSocket 连接升级时使用 | |
| Processing | 服务器已收到请求并正在处理，但无响应可用 | WebDAV 中用于长时间请求 | |
| Early Hints | 在最终响应前返回部分首部信息 | 预加载关键资源，优化页面加载速度 | |
| OK | 请求成功 | 最常见的成功响应，GET、POST 均可返回 | |
| Created | 请求成功且新资源已创建 | POST 请求创建新资源后的响应 | |
| Accepted | 请求已接收但尚未处理完成 | 异步任务提交后返回，表示任务已加入队列 | |
| No Content | 请求成功但无返回内容 | DELETE 操作成功，或不需要返回数据时的响应 | |
| Partial Content | 请求成功，返回部分内容 | 断点续传、视频流播放时的分片响应 | |
| Moved Permanently | 资源永久转移到新的 URL | 网站迁移到新域名时使用，搜索引擎会更新索引 | |
| Found (Moved Temporarily) | 资源临时转移到新的 URL | 登录后重定向回原页面 | |
| Not Modified | 资源未修改，使用缓存副本 | 浏览器缓存验证，节省带宽 | |
| Temporary Redirect | 临时重定向，保持请求方法和请求体不变 | POST 请求重定向时保证请求体不被修改 | |
| Permanent Redirect | 永久重定向，保持请求方法和请求体不变 | API 版本迁移，保证 POST 请求正常重定向 | |
| Bad Request | 请求语法错误或参数无效 | 请求参数格式不正确、缺少必填字段时返回 | |
| Unauthorized | 需要用户认证 | 未登录或 Token 过期时返回 | |
| Forbidden | 服务器拒绝请求，即使已认证 | 权限不足，已登录但无权访问该资源 | |
| Not Found | 请求的资源不存在 | 访问的 URL 路径不存在或资源已被删除 | |
| Method Not Allowed | 请求方法不被允许 | 端点不支持当前 HTTP 方法，如用 GET 访问仅接受 POST 的接口 | |
| Request Timeout | 服务器等待请求超时 | 客户端发送请求过慢，服务器主动断开连接 | |
| Conflict | 请求与当前资源状态冲突 | 并发修改导致的数据冲突 | |
| Gone | 资源已永久删除且无转发地址 | 资源永久下线，不同于 404 的不存在 | |
| Payload Too Large | 请求体超过服务器限制 | 上传文件超出大小限制时返回 | |
| Unsupported Media Type | 不支持的媒体格式 | 后端只接受 JSON 但客户端发送了 XML | |
| Unprocessable Entity | 请求格式正确但语义错误 | 参数格式对但值不符合业务规则（如邮箱格式正确但未注册） | |
| Too Many Requests | 请求频率超过限制 | API 限流，提示客户端降低请求频率 | |
| Internal Server Error | 服务器内部错误 | 后端代码异常、未捕获的错误导致 | |
| Bad Gateway | 充当网关或代理的服务器收到无效响应 | Nginx 反向代理时上游服务返回了无效响应 | |
| Service Unavailable | 服务暂时不可用 | 服务器过载或正在维护中，通常带 Retry-After 头 | |
| Gateway Timeout | 网关超时 | 反向代理等待上游服务响应超时 |
点击状态码即可复制到剪贴板