理解 HTTP 状态码：完整参考

HTTP 状态码是 Web 服务器返回的三位数字，用于指示客户端请求的结果。

状态码类别

1xx - 信息

• 100 Continue：服务器收到头部，客户端应发送正文
• 101 Switching Protocols：切换到 WebSocket 等协议

2xx - 成功

• 200 OK：标准成功响应
• 201 Created：新资源已创建
• 204 No Content：成功但无内容返回

3xx - 重定向

• 301 Moved Permanently：永久移动（SEO 友好）
• 302 Found：临时重定向
• 304 Not Modified：缓存版本仍然有效

4xx - 客户端错误

• 400 Bad Request：请求语法错误
• 401 Unauthorized：需要认证
• 403 Forbidden：已认证但未授权
• 404 Not Found：资源不存在
• 429 Too Many Requests：超出速率限制

5xx - 服务器错误

• 500 Internal Server Error：通用服务器错误
• 502 Bad Gateway：上游服务器响应无效
• 503 Service Unavailable：服务器过载或维护中

API 设计最佳实践

1. 资源创建使用 201 而不是 200

2. 无响应体的成功删除使用 204

3. 正确区分 401 和 403

在我们的 HTTP 状态码参考工具中查看完整列表。