T工具箱
🚦

HTTP 状态码

查询状态码含义与使用场景

关于此工具

HTTP 状态码(HTTP Status Codes,由 IETF RFC 7231 与 IANA 统一维护)是客户端(浏览器、移动 App、爬虫)与 Web 服务器进行通信时,服务器返回给客户端的三位数字应答标识。状态码第一位数字定义了响应的大类(1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务器错误),是前后端接口对接排错、网络运维、SEO 搜索引擎抓取诊断的核心技术规范。本工具提供全量状态码速查、详细语义解读与线上常见故障解决方案。

如何使用本工具(操作步骤)

1

输入状态码数字或关键字搜索

在搜索栏输入具体的三位数字(如 403、502)或英文短语(如 Unauthorized、Bad Gateway),系统即刻过滤定位。

2

按响应大类快速筛选

点击分类标签(1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误),快速浏览同类状态码。

3

查看语义定义与排错方案

点击目标状态码卡片,查看其官方语义规范、适用场景、常见引发根因以及前后端排查修复建议。

覆盖 IANA 全量官方标准状态码

收录从经典 200 OK 到 418 I'm a teapot 等全量标准状态码,以及现代 WebDAV 与微服务扩展定义。

针对性提供线上故障排查指南

深入剖析开发中最头疼的 401/403 跨域鉴权失效、502 宝塔/Nginx 网关网断、504 超时等故障原因与修复建议。

SEO 爬虫收录与权重影响说明

特别注明 301 永久重定向与 302 临时重定向对 Google 权重传递的区别,以及 404 与 410 页面对爬虫抓取预算的影响。

线上经典报错排查与 SEO 权重传递指南

  • •401 vs 403 的核心本质区别:401(Unauthorized)本质是“你还没登录,我不认识你”;403(Forbidden)本质是“我知道你是谁,但以你的身份等级,禁止访问这个页面”。401 应弹出登录框,403 应提示权限不足。
  • •网站改版务必使用 301 永久重定向:当更换域名或调整 URL 路径时,必须配置 HTTP 301 状态码,告诉 Google 爬虫该内容已永久搬家,爬虫会将旧 URL 积累的所有 SEO 权重完全迁移到新地址;若错误使用 302(临时跳转),权重将无法继承!
  • •Nginx 报 502 Bad Gateway 的常见病因:502 代表 Nginx 作为反向代理,连接不上上游后端服务(如 Node.js、PHP-FPM、Tomcat)。90% 的原因是后端应用进程意外崩溃退出(OOM 内存溢出)或监听端口不匹配。

代码与转换对比示例

高频常见 HTTP 状态码快速参考表

常见状态码与含义
• 200 OK                  : 请求成功,正常返回数据
• 301 Moved Permanently   : 永久重定向,搜索引擎传递页面权重
• 400 Bad Request         : 客户端请求参数校验失败
• 401 Unauthorized        : 未携带鉴权凭据或凭据失效
• 403 Forbidden           : 已登录但无访问该资源权限
• 404 Not Found           : 服务器找不到请求的资源
• 500 Internal Error      : 后端程序发生未捕获异常崩溃
• 502 Bad Gateway         : Nginx 网关无法连接到后端应用
• 504 Gateway Timeout     : 后端应用处理超时未响应网关
五大类别特征划分
• 1xx : 协议中间状态,提示客户端继续
• 2xx : 请求已被成功接收、理解并处理
• 3xx : 需要客户端采取进一步动作(跳转重定向)
• 4xx : 客户端引发的错误(入参、权限、地址错误)
• 5xx : 服务端引发的错误(崩溃、超时、网关断开)

* 区分 4xx 与 5xx 是界定前端责任还是后端责任的第一依据。

前端 Fetch API 状态码通用拦截处理代码范式

全局网络请求拦截逻辑
async function request(url, options) {
  const response = await fetch(url, options);
  if (response.ok) {
    return await response.json(); // 状态码 200-299 视为成功
  }
  if (response.status === 401) {
    redirectToLogin(); // 401 自动跳转登录页
  } else if (response.status === 403) {
    alert("您暂无访问该模块的权限");
  } else if (response.status >= 500) {
    alert("服务器内部繁忙,请稍后再试");
  }
  throw new Error("HTTP Error: " + response.status);
}
重要注意事项
注意:fetch() 只要成功收到服务器响应(即便是 404 或 500),Promise 也不会 reject!必须通过 response.ok 或 response.status 手动检查。

* 许多前端新手常误以为 404/500 会触发 catch,实际上必须手动检验 `response.ok`。

常见问题解答

Q: 为什么 404 页面不能返回 200 状态码(软 404 隐患)?

A: 如果网页内容提示“页面已不存在”,但 HTTP 响应头却返回了 200 OK,这被称为“Soft 404(软 404)”。Google 爬虫会错误地以为这是正常页面并继续索引,严重浪费站点的抓取预算,并导致垃圾聚合页泛滥而遭到惩罚。

Q: 304 Not Modified 是错误状态码吗?

A: 完全不是错误。304 是协商缓存(Conditional GET)的核心机制。客户端向服务器询问“我缓存的文件改动过吗?”,服务器回答 304 意味着“文件未变动,请直接使用本地缓存”,无需传输任何响应体,极大加速加载并节省流量。

Q: 神秘的 418 I'm a teapot(我是一个茶壶)是怎么来的?

A: 418 诞生于 1998 年 IETF 发布的愚人节恶搞 RFC 2324(超文本咖啡壶控制协议 HTCPCP)。该状态码用于在试图向一个茶壶冲泡咖啡时返回错误,如今被作为互联网著名的极客彩蛋被各大云服务和框架保留。

相关推荐工具

所有处理都在你的浏览器本地完成,数据不会上传到服务器。
/