# 响应代码

### 一、1xx：信息性（Informational）

表示请求已接收，正在处理，很少在业务中直接使用

| 状态码 | 名称                  | 含义                       |
| --- | ------------------- | ------------------------ |
| 100 | Continue            | 客户端可继续发送请求体              |
| 101 | Switching Protocols | 协议切换（如 HTTP → WebSocket） |
| 102 | Processing          | 服务器处理中（WebDAV）           |

常见于：WebSocket、HTTP Upgrade

### 二、2xx：成功（Success）

请求成功处理

| 状态码 | 名称              | 含义           |
| --- | --------------- | ------------ |
| 200 | OK              | 请求成功         |
| 201 | Created         | 资源创建成功（POST） |
| 202 | Accepted        | 已接收，异步处理     |
| 204 | No Content      | 成功但无返回体      |
| 206 | Partial Content | 分块/断点下载      |

常见于：API 正常返回、文件下载、代理转发成功

### 三、3xx：重定向（Redirection）

需要进一步操作

| 状态码 | 名称                 | 含义          |
| --- | ------------------ | ----------- |
| 301 | Moved Permanently  | 永久重定向       |
| 302 | Found              | 临时重定向       |
| 303 | See Other          | 重定向到 GET    |
| 304 | Not Modified       | 缓存有效        |
| 307 | Temporary Redirect | 临时重定向（方法不变） |
| 308 | Permanent Redirect | 永久重定向（方法不变） |

常见于：CDN、HTTP → HTTPS、缓存控制

### 四、4xx：客户端错误（Client Error）

请求有问题

| 状态码 | 名称                 | 含义           |
| --- | ------------------ | ------------ |
| 400 | Bad Request        | 请求格式错误       |
| 401 | Unauthorized       | 未认证（缺 token） |
| 403 | Forbidden          | 已认证但无权限      |
| 404 | Not Found          | 资源不存在        |
| 405 | Method Not Allowed | 方法不支持        |
| 408 | Request Timeout    | 请求超时         |
| 409 | Conflict           | 资源冲突         |
| 413 | Payload Too Large  | 请求体过大        |
| 414 | URI Too Long       | URL 过长       |
| 429 | Too Many Requests  | 限流           |

* 401 / 403：鉴权失败
* 404：目标服务器不存在
* 429：IP / 用户限流

### 五、5xx：服务器错误（Server Error）

服务器处理失败

| 状态码 | 名称                    | 含义      |
| --- | --------------------- | ------- |
| 500 | Internal Server Error | 服务器内部错误 |
| 502 | Bad Gateway           | 上游服务器无效 |
| 503 | Service Unavailable   | 服务不可用   |
| 504 | Gateway Timeout       | 上游超时    |
| 507 | Insufficient Storage  | 存储不足    |