关于此工具
HTTP 状态码(HTTP Status Codes,由 IETF RFC 7231 与 IANA 统一维护)是客户端(浏览器、移动 App、爬虫)与 Web 服务器进行通信时,服务器返回给客户端的三位数字应答标识。状态码第一位数字定义了响应的大类(1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务器错误),是前后端接口对接排错、网络运维、SEO 搜索引擎抓取诊断的核心技术规范。本工具提供全量状态码速查、详细语义解读与线上常见故障解决方案。
如何使用本工具(操作步骤)
输入状态码数字或关键字搜索
在搜索栏输入具体的三位数字(如 403、502)或英文短语(如 Unauthorized、Bad Gateway),系统即刻过滤定位。
按响应大类快速筛选
点击分类标签(1xx 信息、2xx 成功、3xx 重定向、4xx 客户端错误、5xx 服务端错误),快速浏览同类状态码。
查看语义定义与排错方案
点击目标状态码卡片,查看其官方语义规范、适用场景、常见引发根因以及前后端排查修复建议。
覆盖 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)。该状态码用于在试图向一个茶壶冲泡咖啡时返回错误,如今被作为互联网著名的极客彩蛋被各大云服务和框架保留。