HTTPHTTP 状态码速查表

查询常用 HTTP 状态码,定位认证、权限、缓存和网关问题。

2002xx 成功

OK

请求成功。常规 GET、POST 响应的标准状态码。

2012xx 成功

Created

已创建。POST/PUT 成功并在服务端创建了新资源。

2042xx 成功

No Content

无内容。请求成功处理,但响应体不包含任何实体内容(如 DELETE 成功)。

3013xx 重定向

Moved Permanently

永久重定向。资源已被分配了新的永久 URI,搜索引擎会转移权重。

3023xx 重定向

Found

临时重定向。资源临时位于其他 URI,搜索引擎保留原 URL。

3043xx 重定向

Not Modified

未修改。协商缓存命中(基于 ETag / If-Modified-Since),客户端可直接使用本地缓存。

4004xx 客户端错误

Bad Request

客户端请求语法错误,如 JSON 格式损坏、缺少必填参数。

4014xx 客户端错误

Unauthorized

未授权。当前请求需要用户身份验证凭证(Token/Cookie)或凭证无效。

4034xx 客户端错误

Forbidden

禁止访问。服务器理解请求但拒绝授权,通常为权限不足(Role/ACL)。

4044xx 客户端错误

Not Found

资源未找到。请求的 URL 路径在服务器上不存在。

4054xx 客户端错误

Method Not Allowed

方法不允许。如接口只支持 POST,客户端使用了 GET 请求。

4294xx 客户端错误

Too Many Requests

请求过多(限流)。用户在给定的时间内发送了过多请求(Rate Limit)。

5005xx 服务端错误

Internal Server Error

服务器内部错误。后端代码抛出未捕获的未处理异常。

5025xx 服务端错误

Bad Gateway

错误网关。作为网关或反向代理的服务器从上游服务接收到无效响应。

5035xx 服务端错误

Service Unavailable

服务不可用。服务器目前无法处理请求,可能由于临时超载或停机维护。

5045xx 服务端错误

Gateway Timeout

网关超时。反向代理(如 Nginx)向上游应用服务器请求超时未得到响应。

操作指南 · 示例 · 使用边界

如何使用与核对结果

适合接口联调时快速判断请求失败发生在客户端、认证授权、应用服务还是网关。状态码只是线索,需要结合响应头、请求 ID 和服务端日志确认。

操作步骤

  1. 输入数字或名称过滤常用状态码,例如 401、429 或 Gateway。
  2. 先确认状态码由源站还是 CDN / 反向代理返回,再检查响应体。
  3. 使用请求 ID 对照服务端日志;重试前确认接口幂等性与 Retry-After。

可复现示例

按状态码查找排错方向

输入

响应: HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer

预期结果

优先检查令牌是否存在、是否过期、是否发给正确受众;403 则进一步检查权限。

限制与容易忽略的细节

  • 本页是常用码速查,并非 IANA 完整注册表。
  • 304 是缓存验证响应,通常不带新的资源内容;不要当成普通重定向。
  • 301/308 和 302/307 表达不同迁移意图,不能据此承诺搜索排名或收录。

技术参考:HTTP 状态码官方注册表

发现结果与示例不符?请通过联系反馈提供脱敏输入和预期结果。

常见问题解答 (FAQ)

Q:301 永久重定向与 302 临时重定向对 SEO 有什么影响?
301/308 表示永久迁移,是搜索引擎选择目标 URL 为规范网址的强信号;302/307 表示临时迁移。Google 会结合其他信号决定规范网址,重定向不能保证排名或收录。
已成功复制到剪贴板