首页 / 开发者工具 / HTTP 状态码
参考

HTTP状态码详解

使用本页快速了解响应码的含义、问题位于客户端还是服务器端,以及哪些状态码在调试和 API 工作中最重要。

最适合 API 调试和 Web 响应排查与 HTTP状态码查询搭配使用

状态码分组

1xx 信息性

请求仍在进行中。这些状态码在常规浏览器调试中不常见。

2xx 成功

请求成功。 200, 201,以及 204 最常出现。

3xx 重定向

客户端需要跟随另一个 URL 或使用缓存内容。

4xx 客户端错误

请求无效、未授权、缺失或受到速率限制。

5xx 服务器错误

服务器在处理有效请求时失败。

实际常用的状态码

状态码含义典型场景
200正常正常的成功 GET 或 POST 响应
201已创建POST 后资源创建成功
301永久移动URL 已永久变更,请更新链接和规范目标
302已找到临时重定向,常见于登录或短期路由
400错误请求负载格式错误或缺少必需参数
401未授权缺少认证或认证无效
403禁止访问已验证身份,但无权访问此资源
404未找到路由、文件或资源不存在
429请求过多超出速率限制
500服务器内部错误未处理的服务器端故障

快速调试检查清单

  • 如果状态码为 4xx,请先检查请求:认证、负载结构、URL、请求头。
  • 如果状态码为 5xx,请先检查服务器和日志。
  • 如果状态码为 301 或 302,请确认重定向目标以及该行为是否符合预期。
  • 如果状态码为 429,请添加重试逻辑或退避策略,而不是频繁请求该端点。

配合合适的工具使用本参考

相关工具