HTTP 状态码完整列表：1xx 到 5xx 详解

**更新时间：** 2026-03-27

**阅读时间：** 约 15 分钟

---

什么是 HTTP 状态码？

HTTP 状态码（HTTP Status Code）是服务器对客户端请求的响应状态指示。当浏览器或其他客户端向服务器发送 HTTP 请求时，服务器会返回一个三位数字的状态码，表示请求的处理结果。

状态码由 IETF（互联网工程任务组）在 RFC 文档中定义，是 HTTP 协议的核心组成部分。理解这些状态码对于 Web 开发、API 调试、故障排查和 SEO 优化都至关重要。

---

HTTP 状态码分类

HTTP 状态码分为五大类，由首位数字标识：

| 分类 | 范围 | 含义 | 说明 |

|------|------|------|------|

| 1xx | 100-199 | 信息性响应 | 请求已接收，继续处理 |

| 2xx | 200-299 | 成功 | 请求已成功处理 |

| 3xx | 300-399 | 重定向 | 需要进一步操作以完成请求 |

| 4xx | 400-499 | 客户端错误 | 请求包含错误或无法完成 |

| 5xx | 500-599 | 服务器端错误 | 服务器处理请求时发生错误 |

---

HTTP 状态码分类总览

flowchart LR
    subgraph 1xx["1xx 信息性"]
        I1["100 Continue
客户端继续"]
        I2["101 Switching Protocols
协议切换"]
    end
    subgraph 2xx["2xx 成功"]
        S1["200 OK"]
        S2["201 Created
资源已创建"]
        S3["204 No Content
成功无返回"]
    end
    subgraph 3xx["3xx 重定向"]
        R1["301 永久移动"]
        R2["302 临时移动"]
        R3["304 Not Modified
缓存命中"]
    end
    subgraph 4xx["4xx 客户端错误"]
        C1["400 Bad Request"]
        C2["401 Unauthorized"]
        C3["403 Forbidden"]
        C4["404 Not Found"]
        C5["429 Too Many Requests"]
    end
    subgraph 5xx["5xx 服务器错误"]
        E1["500 Internal Error"]
        E2["502 Bad Gateway"]
        E3["503 Service Unavailable"]
        E4["504 Gateway Timeout"]
    end
    1xx --> 2xx --> 3xx --> 4xx --> 5xx
    style 1xx fill:#3498db,color:#fff
    style 2xx fill:#27ae60,color:#fff
    style 3xx fill:#f39c12,color:#fff
    style 4xx fill:#e74c3c,color:#fff
    style 5xx fill:#9b59b6,color:#fff

1xx 信息性响应（Informational）

这类状态码表示请求已被接收，客户端应继续发送请求或等待服务器进一步指示。

100 Continue

**含义：** 服务器已收到请求头，客户端应继续发送请求体。

**使用场景：**

• 客户端发送大型请求体前，先发送带 Expect: 100-continue 头的请求
• 服务器确认可以接收后，客户端再发送完整请求体
• 避免客户端发送大量数据后服务器拒绝接收

**示例：**

POST /upload HTTP/1.1
Host: example.com
Content-Length: 1000000
Expect: 100-continue

HTTP/1.1 100 Continue

[客户端继续发送请求体]

101 Switching Protocols

**含义：** 服务器同意切换协议。

**使用场景：**

• WebSocket 连接升级（从 HTTP 升级到 WebSocket 协议）
• HTTP/2 协议升级

**示例：**

GET /chat HTTP/1.1
Host: example.com
Upgrade: websocket
Connection: Upgrade

HTTP/1.1 101 Switching Protocols
Upgrade: websocket
Connection: Upgrade

103 Early Hints

**含义：** 服务器在最终响应之前返回一些响应头。

**使用场景：**

• 提前告知客户端需要预加载的资源（如 CSS、JS 文件）
• 优化页面加载性能

**示例：**

HTTP/1.1 103 Early Hints
Link: ; rel=preload; as=style
Link: ; rel=preload; as=script

HTTP/1.1 200 OK
...

---

2xx 成功响应（Success）

这类状态码表示请求已成功被服务器接收、理解并处理。

200 OK

**含义：** 请求成功。

**使用场景：**

• GET 请求成功返回资源
• POST 请求成功处理
• 最常见的成功状态码

**示例：**

GET /index.html HTTP/1.1
Host: example.com

HTTP/1.1 200 OK
Content-Type: text/html
Content-Length: 1234

...

201 Created

**含义：** 请求成功并且服务器创建了新的资源。

**使用场景：**

• POST 请求创建新资源（如新用户、新文章）
• PUT 请求创建新资源

**示例：**

POST /api/users HTTP/1.1
Host: example.com
Content-Type: application/json

{"name": "张三", "email": "zhangsan@example.com"}

HTTP/1.1 201 Created
Location: /api/users/123
Content-Type: application/json

{"id": 123, "name": "张三", "email": "zhangsan@example.com"}

202 Accepted

**含义：** 请求已接受，但尚未处理完成。

**使用场景：**

• 异步处理任务（如批量数据处理、视频转码）
• 后台任务队列

**示例：**

POST /api/export HTTP/1.1
Host: example.com

HTTP/1.1 202 Accepted
Location: /api/export/status/abc123

{"status": "processing", "jobId": "abc123"}

204 No Content

**含义：** 请求成功，但响应体为空。

**使用场景：**

• DELETE 请求成功删除资源
• PUT 请求更新资源但不需要返回内容
• 避免返回不必要的空响应体

**示例：**

DELETE /api/users/123 HTTP/1.1
Host: example.com

HTTP/1.1 204 No Content

206 Partial Content

**含义：** 服务器成功处理了部分 GET 请求（范围请求）。

**使用场景：**

• 断点续传下载
• 视频流媒体分片加载
• 大文件分段下载

**示例：**

GET /video.mp4 HTTP/1.1
Host: example.com
Range: bytes=0-1048575

HTTP/1.1 206 Partial Content
Content-Range: bytes 0-1048575/10485760
Content-Length: 1048576

[返回前 1MB 数据]

---

3xx 重定向（Redirection）

这类状态码表示客户端需要采取进一步的操作才能完成请求。

301 Moved Permanently

**含义：** 请求的资源已永久移动到新位置。

**使用场景：**

• 网站域名变更
• URL 结构永久调整
• HTTP 强制跳转到 HTTPS
• SEO 友好，搜索引擎会更新索引

**示例：**

GET /old-page HTTP/1.1
Host: example.com

HTTP/1.1 301 Moved Permanently
Location: https://example.com/new-page

302 Found

**含义：** 请求的资源临时移动到新位置。

**使用场景：**

• 临时维护页面跳转
• A/B 测试重定向
• 登录后跳转回原页面
• 搜索引擎保留原 URL 索引

**示例：**

GET /promo HTTP/1.1
Host: example.com

HTTP/1.1 302 Found
Location: /promo-2026

304 Not Modified

**含义：** 资源未修改，客户端可以使用缓存版本。

**使用场景：**

• 浏览器缓存验证
• 减少带宽消耗
• 提升页面加载速度

**示例：**

GET /style.css HTTP/1.1
Host: example.com
If-Modified-Since: Wed, 26 Mar 2026 10:00:00 GMT

HTTP/1.1 304 Not Modified

307 Temporary Redirect

**含义：** 临时重定向，但要求客户端保持原请求方法不变。

**使用场景：**

• 临时维护跳转
• 与 302 类似，但更严格（保持 POST 方法）

**示例：**

POST /api/submit HTTP/1.1
Host: example.com

HTTP/1.1 307 Temporary Redirect
Location: /api/submit-new

308 Permanent Redirect

**含义：** 永久重定向，但要求客户端保持原请求方法不变。

**使用场景：**

• 永久 URL 变更
• 与 301 类似，但保持 POST 方法

**示例：**

POST /old-api/submit HTTP/1.1
Host: example.com

HTTP/1.1 308 Permanent Redirect
Location: /new-api/submit

---

4xx 客户端错误（Client Error）

这类状态码表示请求包含错误或服务器无法处理该请求。

常见 4xx 错误排查流程

flowchart TD
    A[收到 4xx 错误] --> B{状态码}
    B -->|400| C["请求语法错误
检查请求格式、JSON结构"]
    B -->|401| D{"认证方式"}
    D -->|未认证| E["登录获取 Token"]
    D -->|Token无效| F["Token 过期/无效
刷新或重新登录"]
    B -->|403| G{"权限检查"}
    G -->|角色不对| H["联系管理员提升权限"]
    G -->|IP被封| I["检查 IP 黑名单"]
    B -->|404| J["检查 URL 是否正确
资源是否被删除/迁移"]
    B -->|429| K["请求频率过高
添加重试延迟/限流"]
    C --> L[修正后重试]
    E --> L
    F --> L
    H --> L
    J --> L
    K --> L

400 Bad Request

**含义：** 服务器无法理解请求，通常是因为语法错误。

**常见原因：**

• 请求体格式错误（如 JSON 语法错误）
• 缺少必需的请求头
• 请求参数格式不正确

**解决方案：**

• 检查请求体格式
• 验证请求参数
• 查看服务器日志获取详细错误信息

401 Unauthorized

**含义：** 请求需要用户认证。

**常见原因：**

• 未提供认证凭据
• 认证凭据已过期
• Token 无效

**解决方案：**

• 添加有效的认证头（如 Authorization: Bearer ）
• 重新登录获取新的 Token
• 检查 Token 有效期

403 Forbidden

**含义：** 服务器理解请求，但拒绝执行。

**常见原因：**

• 用户没有权限访问该资源
• IP 地址被禁止
• 请求被安全策略阻止

**解决方案：**

• 联系管理员获取权限
• 检查 IP 是否被防火墙阻止
• 验证访问令牌权限范围

404 Not Found

**含义：** 服务器找不到请求的资源。

**常见原因：**

• URL 拼写错误
• 资源已被删除
• 路径不正确

**解决方案：**

• 检查 URL 拼写
• 确认资源是否存在
• 查看网站地图寻找正确路径

405 Method Not Allowed

**含义：** 请求方法不被允许。

**常见原因：**

• 对只支持 GET 的接口发送 POST 请求
• API 不支持该操作

**解决方案：**

• 查看 API 文档确认支持的方法
• 使用正确的 HTTP 方法

408 Request Timeout

**含义：** 服务器等待请求超时。

**常见原因：**

• 网络延迟
• 客户端发送请求过慢
• 服务器超时设置过短

**解决方案：**

• 检查网络连接
• 增加请求超时时间
• 优化请求数据大小

429 Too Many Requests

**含义：** 用户在给定时间内发送了太多请求。

**常见原因：**

• 触发 API 速率限制
• 频繁请求被限流

**解决方案：**

• 降低请求频率
• 实现请求重试机制（带退避策略）
• 联系服务提供商提升配额

---

5xx 服务器端错误（Server Error）

stateDiagram-v2
    [*] --> Healthy : 正常服务
    Healthy --> LoadHigh : 负载过高
    LoadHigh --> 503 : 服务不可用
    Healthy --> 500 : 代码异常
    Healthy --> 502 : 上游网关错误
    Healthy --> 504 : 网关超时
    503 --> Recovering : 自动恢复
    Recovering --> Healthy

这类状态码表示服务器在处理请求时发生了错误。

500 Internal Server Error

**含义：** 服务器遇到意外情况，无法完成请求。

**常见原因：**

• 服务器代码错误
• 数据库连接失败
• 服务器配置错误

**解决方案：**

• 查看服务器错误日志
• 检查应用程序代码
• 验证数据库连接
• 联系网站管理员

502 Bad Gateway

**含义：** 作为网关或代理的服务器从上游服务器收到无效响应。

**常见原因：**

• 后端服务崩溃
• 代理配置错误
• 网络连接问题

**解决方案：**

• 检查后端服务状态
• 验证代理配置
• 重启相关服务

503 Service Unavailable

**含义：** 服务器暂时无法处理请求。

**常见原因：**

• 服务器过载
• 系统维护中
• 资源耗尽

**解决方案：**

• 稍后重试
• 查看服务状态页面
• 联系服务提供商

504 Gateway Timeout

**含义：** 作为网关或代理的服务器未及时从上游服务器收到响应。

**常见原因：**

• 后端服务响应过慢
• 网络延迟
• 超时设置过短

**解决方案：**

• 增加超时时间
• 优化后端服务性能
• 检查网络连接

---

HTTP 状态码快速参考表

1xx 信息性响应

| 状态码 | 名称 | 说明 |

|--------|------|------|

| 100 | Continue | 继续发送请求 |

| 101 | Switching Protocols | 切换协议 |

| 103 | Early Hints | 提前提示信息 |

2xx 成功响应

| 状态码 | 名称 | 说明 |

|--------|------|------|

| 200 | OK | 请求成功 |

| 201 | Created | 资源已创建 |

| 202 | Accepted | 请求已接受 |

| 204 | No Content | 成功但无内容 |

| 206 | Partial Content | 部分内容 |

3xx 重定向

| 状态码 | 名称 | 说明 |

|--------|------|------|

| 301 | Moved Permanently | 永久移动 |

| 302 | Found | 临时移动 |

| 304 | Not Modified | 未修改（使用缓存） |

| 307 | Temporary Redirect | 临时重定向 |

| 308 | Permanent Redirect | 永久重定向 |

4xx 客户端错误

| 状态码 | 名称 | 说明 |

|--------|------|------|

| 400 | Bad Request | 请求错误 |

| 401 | Unauthorized | 未授权 |

| 403 | Forbidden | 禁止访问 |

| 404 | Not Found | 未找到 |

| 405 | Method Not Allowed | 方法不允许 |

| 408 | Request Timeout | 请求超时 |

| 429 | Too Many Requests | 请求过多 |

5xx 服务器端错误

| 状态码 | 名称 | 说明 |

|--------|------|------|

| 500 | Internal Server Error | 服务器内部错误 |

| 502 | Bad Gateway | 网关错误 |

| 503 | Service Unavailable | 服务不可用 |

| 504 | Gateway Timeout | 网关超时 |

---

状态码选择最佳实践

对于 API 开发者

• **创建资源**：使用 201 Created，并在 Location 头中返回新资源 URL
• **更新资源**：使用 200 OK（返回更新后的资源）或 204 No Content（不返回内容）
• **删除资源**：使用 204 No Content
• **异步处理**：使用 202 Accepted，并提供状态查询接口
• **参数错误**：使用 400 Bad Request，并在响应体中说明具体错误
• **认证失败**：使用 401 Unauthorized
• **权限不足**：使用 403 Forbidden
• **资源不存在**：使用 404 Not Found
• **限流**：使用 429 Too Many Requests，并在响应头中说明限制信息

对于 SEO 优化

• **永久 URL 变更**：使用 301 Moved Permanently，搜索引擎会更新索引
• **临时活动页面**：使用 302 Found，搜索引擎保留原 URL
• **内容已删除**：使用 410 Gone（比 404 更明确）
• **避免软 404**：确保真正不存在的页面返回 404，而不是 200

对于用户体验

• **友好的错误页面**：为 404、500 等错误设计友好的提示页面
• **明确的错误信息**：在 4xx 错误中提供清晰的解决建议
• **重试机制**：对于 503、504 等临时错误，实现自动重试

---

相关工具

• HTTP 状态码查询工具 - 交互式查询 24 个常用状态码
• HTTP 报文解析工具 - 分析 HTTP 请求和响应报文
• URL 编码工具 - 处理 URL 中的特殊字符编码

---

延伸阅读

• HTTP 协议详解 - HTTP/1.1 到 HTTP/3 全版本对比
• HTTPS 协议详解 - 安全 HTTP 通信原理
• TCP/IP 入门教程 - 网络通信基础

---

**最后更新：** 2026-03-27

**本文地址：** https://www.tongxinxieyi.com/articles/12-http-status-codes-complete-guide.html