HTTP 状态码概述

HTTP 状态码是服务器对客户端请求的响应状态标识，由三位数字组成，分为五大类别。了解状态码是 Web 开发、API 调试和运维的必备技能。

一、状态码分类

• 1xx（信息性）：请求已被接收，继续处理。
• 2xx（成功）：请求已成功被服务器接收、理解并接受。
• 3xx（重定向）：需要进一步操作以完成请求。
• 4xx（客户端错误）：请求包含语法错误或无法完成。
• 5xx（服务端错误）：服务器在处理请求的过程中发生了错误。

二、常用状态码详解

• 200 OK：最成功，一切正常。
• 301 Moved Permanently：资源永久移动，搜索引擎会更新索引。
• 302 Found：临时移动，搜索引擎保留原 URL。
• 400 Bad Request：请求格式错误，检查参数。
• 401 Unauthorized：需要认证，提供凭证。
• 403 Forbidden：无权限访问。
• 404 Not Found：资源不存在，检查 URL。
• 500 Internal Server Error：服务器内部错误，查看日志。
• 502 Bad Gateway：网关错误，检查上游服务。
• 503 Service Unavailable：服务不可用，可能过载或维护。

三、如何快速查询

使用本工具可通过分类浏览、关键词搜索快速定位状态码，点击卡片获取详细原因和解决方案，极大提升排查效率。

四、开发者最佳实践

• 客户端应正确处理所有状态码，而非只处理 200。
• API 设计应规范使用状态码，例如 201 表示创建成功，204 表示无内容。
• 使用重定向时，优先使用 301/302，并带上 Location 头。
• 错误响应应包含友好提示，而非直接返回堆栈信息。