HTTP 状态码参考

即时查询任何HTTP状态码——含义、常见原因及解决方法。
完整数据表见 references/codes.md。零依赖，完全离线。

使用场景

• - 429是什么意思？
• 我的API返回502，哪里出了问题？
• 401和403有什么区别？
• 哪些5xx错误可以重试？
• Cloudflare 524是什么意思？

状态码范围（快速定位）

1xx 信息类 — 请求已接收，继续处理
2xx 成功类 — 请求已接收、理解并接受
3xx 重定向类 — 需要进一步操作才能完成请求
4xx 客户端错误 — 请求包含错误语法或无法完成
5xx 服务器错误 — 服务器未能完成明显有效的请求

查询步骤

1. 1. 在 references/codes.md 中查找具体状态码
2. 若未找到，根据范围推断（4xx = 客户端错误，5xx = 服务器错误）
3. 注意来源类别：RFC标准 / WebDAV / Nginx / Cloudflare / 非官方
4. 返回：含义 + 常见原因 + 建议操作

输出格式

单个状态码查询

🔢 HTTP 429 — 请求过多
━━━━━━━━━━━━━━━━━━━━
类别： 4xx 客户端错误
标准： RFC 6585
含义： 用户在给定时间内发送了过多请求（速率限制）。

常见原因：
• API速率限制超限
• 突发流量触发限流策略
• 未处理 Retry-After 响应头

解决方法：
• 检查 Retry-After 响应头中的等待时间
• 在客户端实现指数退避策略
• 审查请求频率并添加限流逻辑
• 考虑缓存响应以减少请求量

相关状态码：503（服务器过载）

对比查询

🔢 401 vs 403
━━━━━━━━━━━━━━━━━━━━
401 未授权
→ 需要身份验证但验证失败或未提供
→ 您需要先登录
→ 解决方法：提供有效的凭据/令牌

403 禁止访问
→ 服务器理解请求但拒绝授权
→ 您已登录但没有权限
→ 解决方法：检查用户角色/权限，联系管理员

关键区别：
401 = 身份未知（未认证）
403 = 身份已知但访问被拒（未授权）

可重试状态码

✅ 通常可安全重试（需退避策略）：
408 请求超时
429 请求过多 ← 需遵循 Retry-After 响应头
500 服务器内部错误 ← 临时性服务器问题
502 网关错误 ← 上游服务暂时不可用
503 服务不可用 ← 服务器过载/维护中
504 网关超时 ← 上游服务超时

❌ 请勿盲目重试：
400 错误请求 ← 先修正请求
401 未授权 ← 先重新认证
403 禁止访问 ← 重试无效
404 未找到 ← 资源不存在
422 无法处理的实体 ← 先修正验证错误

备注

• - 关于Nginx专用状态码（444, 494-499）和Cloudflare状态码（520-530），请参见 references/codes.md
• 418 我是茶壶 是真实的RFC 2324状态码——部分服务器将其作为彩蛋实现
• 部分状态码（如103、425、451）较新，可能不被所有客户端/代理支持