| 分类 | 范围 | 含义 | 特点 |
|---|---|---|---|
| 1xx 信息 | 100–199 | 请求已收到,继续处理 | 临时响应,客户端应继续操作 |
| 2xx 成功 | 200–299 | 请求已成功处理 | 标准成功响应 |
| 3xx 重定向 | 300–399 | 需要进一步操作 | 客户端需跳转到新地址 |
| 4xx 客户端错误 | 400–499 | 请求有误,客户端问题 | 请求语法错误或无权访问 |
| 5xx 服务端错误 | 500–599 | 服务器处理请求时出错 | 服务器内部问题,非客户端责任 |
| 状态码 | 记忆要点 |
|---|---|
| 200 OK | 一切正常,最常见的成功响应 |
| 301 vs 302 | 301 永久跳转(SEO 传权重),302 临时跳转(不传权重) |
| 401 vs 403 | 401 未认证(需要登录),403 已认证但无权限(禁止访问) |
| 404 vs 410 | 404 未找到(可能存在),410 永久删除(曾经存在) |
| 500 vs 502 vs 503 | 500 代码错误,502 上游无响应,503 服务暂时不可用 |
| 操作 | 推荐状态码 | 说明 |
|---|---|---|
| GET 成功 | 200 OK | 返回资源 |
| POST 创建成功 | 201 Created | 资源已创建,Location 头指向新资源 |
| DELETE / PUT 无内容 | 204 No Content | 操作成功但无返回体 |
| 参数错误 | 400 Bad Request | 请求体格式错误、缺少必填参数 |
| 未登录 | 401 Unauthorized | 需要携带认证凭据 |
| 无权限 | 403 Forbidden | 已认证但无操作权限 |
| 资源不存在 | 404 Not Found | ID 不存在等 |
| 限流 | 429 Too Many Requests | Retry-After 头告知等待时间 |