HTTP 协议中常见的错误状态码（详细介绍）

以下是 HTTP 协议中常见的错误状态码及其原因的总结，按错误类型分类整理：

4xx 客户端错误

400 Bad Request

• 原因：请求格式错误，服务器无法解析。
• 常见场景：
  • 请求头或请求体语法错误（如 JSON/XML 格式错误）。
  • 缺少必要参数或参数类型不匹配。

401 Unauthorized

• 原因：请求未通过身份验证。
• 常见场景：
  • 未提供身份凭证（如 Token、Cookie）。
  • 提供的凭证已过期或无效。

403 Forbidden

• 原因：服务器拒绝执行请求，即使客户端已认证。
• 常见场景：
  • 用户权限不足（如访问其他用户的私有资源）。
  • IP 地址或设备被限制访问。

404 Not Found

• 原因：请求的资源在服务器上不存在。
• 常见场景：
  • URL 路径错误（如拼写错误）。
  • 资源已被删除或未正确部署。

405 Method Not Allowed

• 原因：请求方法（GET/POST/PUT 等）对目标资源不适用。
• 示例：对只支持 GET 的接口发送 POST 请求。

408 Request Timeout

• 原因：服务器等待请求超时。
• 常见场景：客户端发送请求过慢，或网络延迟过高。

429 Too Many Requests

• 原因：客户端发送的请求频率超过限制。
• 常见场景：短时间内频繁调用 API，触发服务器的限流策略。

5xx 服务器端错误

500 Internal Server Error

• 原因：服务器内部发生未预期的错误。
• 常见场景：
  • 代码逻辑错误（如空指针异常）。
  • 数据库连接失败。

501 Not Implemented

• 原因：服务器不支持请求的功能。
• 示例：请求了一个服务器未实现的 HTTP 方法。

502 Bad Gateway

• 原因：作为代理或网关的服务器从上游服务器收到无效响应。
• 常见场景：
  • 反向代理服务器无法连接后端服务。
  • 上游服务器崩溃或配置错误。

503 Service Unavailable

• 原因：服务器暂时无法处理请求（通常因过载或维护）。
• 常见场景：
  • 服务器维护或重启。
  • 突发的高并发请求导致资源耗尽。

504 Gateway Timeout

• 原因：代理或网关服务器未及时收到上游服务器的响应。
• 常见场景：后端服务处理时间过长，超过网关的等待时间。

505 HTTP Version Not Supported

• 原因：服务器不支持请求使用的 HTTP 协议版本。
• 示例：客户端使用 HTTP/3，但服务器仅支持 HTTP/1.1。

通用排查建议

1. 客户端错误（4xx）：

   • 检查请求的 URL、参数、请求方法、请求头是否符合 API 文档。
   • 验证身份凭证是否有效（如 Token 是否过期）。
   • 通过浏览器开发者工具或抓包工具（如 Fiddler）分析原始请求。

2. 服务端错误（5xx）：

   • 查看服务器日志（如 Nginx/应用日志）定位具体错误堆栈。
   • 检查服务器资源使用情况（CPU、内存、磁盘）。
   • 确认上游服务（如数据库、第三方 API）是否正常运行。

通过状态码可快速定位问题方向，但具体原因需结合服务器日志和请求上下文进一步分析。