HTTP 状态码 - 开发工具 · 萤炬工具箱

HTTP 状态码速查表按 1xx 到 5xx 分类列出常见状态码的标准含义与典型使用场景，附中文说明，可按分类筛选或直接搜索码值。用于排查接口返回、设计 API 响应约定，或看日志时快速确认某个码代表什么。按 1xx–5xx 分类筛选，含中文说明与典型场景。部分状态码有非标准的历史用法，实际行为取决于服务端实现。

HTTP 状态码速查表按 1xx 到 5xx 分类列出常见状态码的标准含义与典型使用场景，附中文说明，可按分类筛选或直接搜索码值。用于排查接口返回、设计 API 响应约定，或看日志时快速确认某个码代表什么。

使用步骤

1. 按分类（1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误）筛选。
2. 或直接搜索码值，如 404、429、502。
3. 阅读标准含义与典型触发场景，判断问题出在客户端还是服务端。

功能与限制

• 按 1xx–5xx 分类筛选，含中文说明与典型场景。
• 部分状态码有非标准的历史用法，实际行为取决于服务端实现。

常见问题

301 和 302 重定向有什么区别？

301 是永久重定向，浏览器和搜索引擎会缓存并把权重转移到新地址；302 是临时的，不转移权重。改域名用 301，临时活动页跳转用 302。

401 和 403 该返回哪个？

401 表示未认证（没登录或凭证无效），客户端应该去认证；403 表示已认证但无权限，再试也没用。前者可重试，后者不可。

502 和 504 的区别是什么？

502 Bad Gateway 是网关收到了上游的无效响应（上游崩了或返回乱数据）；504 Gateway Timeout 是网关等上游超时（上游还活着但太慢）。

429 响应该配什么头？

配 Retry-After 告知客户端多久后可重试（秒数或具体时间）。良好实践还会返回限流剩余额度信息，方便客户端自行控制节奏。

204 和 200 空响应有什么不同？

204 No Content 明确表示「成功但没有响应体」，客户端不应期待 body；200 带空 body 语义模糊，某些客户端会尝试解析导致报错。