HTTP状态码查询

什么是HTTP状态码参考？

HTTP状态码参考是一份全面的HTTP响应状态码速查手册。当客户端向服务器发送HTTP请求时，服务器会返回一个三位数字的状态码，表示请求的处理结果。状态码是HTTP协议的核心组成部分，从1xx（信息性）到5xx（服务器错误），每个状态码都有明确的语义。理解状态码对于Web开发者调试API、排查网站问题、设计合理的错误处理机制至关重要。本参考手册涵盖所有标准HTTP状态码，按类别分组整理，附带每个状态码的含义、使用场景和处理建议，帮助开发者快速定位和理解HTTP通信中的各种响应状态。

如何使用HTTP状态码参考

1. 按类别浏览 — 状态码按1xx-5xx分类，直接浏览对应类别查看所有状态码。
2. 搜索特定状态码 — 输入状态码数字（如404）或关键词（如"Not Found"）快速定位。
3. 查看详情 — 点击状态码查看详细说明，包括含义、常见原因和处理方法。

常见使用场景

技术原理

HTTP状态码按百位数字分为五大类：

// HTTP状态码分类
// 1xx - 信息性（请求已被接收，继续处理）
//   100 Continue        继续请求
//   101 Switching       切换协议

// 2xx - 成功（请求已成功处理）
//   200 OK              成功
//   201 Created         资源已创建
//   204 No Content      成功但无返回体

// 3xx - 重定向（需要进一步操作）
//   301 Moved           永久重定向
//   302 Found           临时重定向
//   304 Not Modified    缓存有效

// 4xx - 客户端错误（请求有误）
//   400 Bad Request     请求语法错误
//   401 Unauthorized    需要认证
//   403 Forbidden       禁止访问
//   404 Not Found       资源不存在
//   429 Too Many Reqs   请求频率超限

// 5xx - 服务器错误（服务器处理失败）
//   500 Internal Error  服务器内部错误
//   502 Bad Gateway     网关错误
//   503 Unavailable     服务不可用
//   504 Gateway Timeout 网关超时

最佳实践与注意事项

• API设计应返回有意义的状态码：创建资源用201，删除用204，验证失败用422。
• 301重定向会被浏览器缓存，测试时应使用302避免缓存影响。
• 401和403的区别：401是"未认证"（可以登录后重试），403是"已认证但无权限"。
• 5xx错误通常需要在服务器日志中查找原因，客户端重试不一定能解决。

常见问题