结构化数据测试与调试：Rich Results测试与错误排查
一、两套测试工具的分工
很多团队把 Schema 写进页面就以为完事了，结果 GSC 里红了一片。结构化数据调试要用两套工具，各管一段。
Rich Results Test 用来测单页，贴 URL 或贴代码片段，看这一页能不能生成富媒体。Schema Markup Validator 用来查 JSON-LD 本身是否合法。
| 工具 | 测什么 | 使用时机 | 局限 |
|---|---|---|---|
| Rich Results Test | 单页富媒体资格 | 上线前逐页测 | 只测你贴的那一页 |
| Schema Validator | JSON-LD 语法合法性 | 写代码时本地查 | 不代表 Google 真展示 |
| GSC 富媒体报告 | 整站已验证页面 | 上线后每周看 | 数据有 2 至 3 天延迟 |
Schema 类型怎么选、字段有哪些，见 结构化数据 Schema 和 结构化数据 Schema 全清单。这篇讲的是写完之后怎么测、错了怎么排。
三套工具的报告口径不一致是正常的：本地测试过了，GSC 可能还要等 2 至 3 天才反映出来。不要因为本地过了就急着下结论。
二、错误与警告：先修哪一类
调试报告里每一条提示都要分级对待。把警告当错误一条条改，会浪费数天时间。
| 级别 | 含义 | 是否影响富媒体 | 处理优先级 |
|---|---|---|---|
| 错误 Error | 必填字段缺失或类型错 | 是，直接丢富媒体 | 立刻修 |
| 警告 Warning | 推荐字段缺失 | 否，仍可展示 | 排期补 |
| 信息 Info | 可选字段建议 | 否 | 有空再补 |
反直觉判断：报告里 80% 的提示是警告。Google 把缺作者、缺日期这类推荐字段标黄，但页面仍然有资格出富媒体。
真正会让富媒体消失的是错误项：比如用了 Article 类型但没写 headline，或者把日期写成字符串而不是 ISO 格式。这两类必须第一时间修。
场景示例：一个博客站 GSC 报 120 页有问题，初看以为全废了。分级后发现 110 页是缺 image 的警告，只有 10 页是 datePublished 格式错误。先修 10 页硬错误，一周后富媒体恢复 80%，警告那批照常出结果。
如果你团队用的是 CMS 模板，一类错误会批量出现。修一个模板里的字段，整批页面在下次抓取后自动恢复，不需要逐页改。这也是为什么要优先修错误：一个模板改动顶得上手动修几十页。
反过来，警告类问题通常和单页内容有关，缺作者、缺主图是逐页的，只能排期慢慢补。
三、四类高频错误的排查方法
B2B 站点最常见的结构化数据错误集中在四类，按出现频率排序如下。
| 错误类型 | 典型表现 | 排查方法 | 修复 |
|---|---|---|---|
| 字段类型错 | 日期写成 2026/10/08 | 看是否 ISO 8601 | 改成 2026-10-08 |
| 嵌套层级错 | Review 脱离 Product | 看 @graph 结构 | Review 嵌进 Product |
| 必填字段缺 | Article 没写 headline | 对照官方字段表 | 补上必填字段 |
| 多 URL 重复 | 分页每页都标 Article | 看 canonical 指向 | 只在主篇标 |
日期格式是最高频的错。Google 要求 ISO 8601，即 2026-10-08，不是 10/08/2026，也不是 Oct 8, 2026。一个斜杠写法就能让整批页面掉富媒体。
另一个隐蔽错误是分页。系列文章第 2 页、第 3 页如果也标了 Article，Google 会判定重复，只保留 canonical 那一篇。其余页要么去掉标记，要么改用 CollectionPage。
富媒体结果怎么获取和维护见 富媒体结果优化；实体标记见 知识图谱实体标记。
四、上线后怎么验证真的生效
本地测试通过不等于线上生效。结构化数据有一个验证周期，要用对方法等。
| 阶段 | 时间 | 你看到什么 | 动作 |
|---|---|---|---|
| 提交修复 | 第 0 天 | GSC 点请求验证 | 不要反复改 |
| 重新抓取 | 第 1 至 7 天 | 报告状态仍为修复中 | 等 |
| 评估完成 | 第 1 至 4 周 | 错误计数下降 | 对照 SERP 看富媒体 |
| 长期监测 | 每月 | 新页是否自动收录 | 纳入技术审计 |
点完请求验证就不要反复改代码。每改一次都会重置 Google 的评估窗口，本来 2 周能完成的验证，拖成 6 周。
验证完成后，去 Google 搜目标词，肉眼看 SERP 是否真的出现星级、FAQ 折叠、面包屑。GSC 说有效不等于用户能看到，有些类型只在特定查询下展示。
如果 GSC 显示有效但 SERP 里看不到富媒体，先确认这个查询本身是否触发富媒体。有些类型只在导航型或信息型查询下出现，交易型查询可能不展示。换几个相关词再搜一次。
长期监测也要做。每次发新页面，一周后到 GSC 看是否被自动识别；没识别的，手动用网址检查工具请求一次。
如果你用的是模板化建站，建议在发布流程里加一道检查：新页面上线前先用 Rich Results Test 跑一遍，通过才允许发布。这一步只要 1 分钟，能避免上线后批量返工。
富媒体不是目的，只是让页面在 SERP 里更醒目。真正决定排名的还是内容和外链，结构化数据只是把已经不错的页面放大 10% 至 20% 的点击率。
所以顺序别搞反：先把内容做到能排进前 20，再上结构化数据去争富媒体位置。内容本身排不上去，标记做得再规范也不会有任何展示。
技术 SEO 审计的完整清单见 技术 SEO 审计清单，结构化数据是其中一项；上线前的预检见 独立站上线检查清单。
五、避坑：调试阶段最常见的三个错误动作
结构化数据调试有三个坑，踩了不仅没效果，还可能招来手动处罚。
| 错误动作 | 后果 | 正确做法 |
|---|---|---|
| 为星级刷单好评 | 违反结构化数据政策 | 只标真实评价 |
| 把警告当错误全改 | 浪费数天，无排名收益 | 先修错误，警告排期 |
| 本地过了就天天改 | 重置验证窗口 | 提交后等 1 至 4 周 |
最严重的是刷单星级。Google 对自评评分、虚假评价有手动处罚，一旦命中，全站富媒体被取消，恢复要数月。只标页面上真实可见的评价。
结构化数据对 AI 抓取也有帮助，见 GEO 技术优化。它不是为了那几个星星，而是让搜索引擎和 AI 都能读懂页面实体。
FAQ 常见问题
Rich Results Test 通过了，为什么搜索结果里还是没有富媒体？
GSC 富媒体报告里的错误和警告有什么区别？
结构化数据最常见的硬错误是什么？
修复完结构化数据错误后，多久能看到效果？
为了出星级评分，能不能自己写几条好评进去？
JSON-LD 写在 head 里还是 body 里有影响吗？
写在最后
结构化数据调试考的不是写 Schema 的能力，是耐心。报告里红一片时先分级，80% 是不用急的警告；提交修复后按 1 至 4 周等，不要天天改代码。
落地三步：单页用 Rich Results Test 过一遍；整站在 GSC 富媒体报告里只先修错误项；修完点请求验证，然后等 Google 重新评估，不要中途返工。
一句可以记住的话：结构化数据通过测试只是入场券，GSC 里点了验证、等满四周、SERP 肉眼看到富媒体，这三步走完才算真的生效。