Google Rich Results Test 是唯一可靠入口，它模拟真实爬虫解析逻辑，检查DOM文本、itemprop一致性、嵌套与类型冲突；必须用Live Test、清缓存、验原始HTML、查绑定关系、禁混用JSON-LD与Microdata。
Google Rich Results Test 是唯一可靠入口
别信浏览器插件或本地校验工具——Google 的 Rich Results Test（现整合进 Search Console 的“富媒体搜索结果”报告）是当前唯一能模拟真实爬虫解析逻辑的验证方式。它不只检查语法，还会提取 DOM 中实际可读的文本、比对 itemprop 值是否与可见内容一致、识别嵌套断层和类型冲突。
常见错误现象：Rich Results Test 显示 “Valid: false”，但没报具体错；点开 “Preview” 卡片字段为空；或提示 “Missing field name” 却页面明明有 <h1 itemprop="name"> —— 这基本是嵌套断裂或文本被 JS 覆盖导致的。
- 必须用
Live Test（而非 URL Test），否则看不到动态注入或 SSR 渲染前的真实 HTML - 测试前清空浏览器缓存，避免旧版 HTML 被缓存服务返回
- 如果页面依赖登录态或地域判断，需在测试时勾选 “Include cookies and authentication”
curl + Googlebot UA 检查原始 HTML 输出
很多问题出在服务端：CMS 自动生成了错误 itemtype，或 CDN 缓存了未渲染的占位符 HTML。直接用命令行抓取，能绕过前端干扰，确认结构化数据是否真正在首屏 HTML 里。
执行：curl -H "User-Agent: Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)" https://yoursite.com/product
使用 PptxGenJS 和 Python 解析，将结构化的 HTML/CSS 幻灯片内容转换为原生、可编辑的 PowerPoint（.pptx）演示文稿。
立即学习“前端免费学习笔记（深入）”；
重点检查：
-
itemscope itemtype="https://schema.org/Product"是否完整、协议是否为https、末尾有没有多余斜杠（https://schema.org/Product/❌） - 所有
itemprop是否都在该itemscope的直接子树内（不能跨父级 div） - 日期、价格等字段是否用了
datetime或content属性提供机器可读值，而非仅靠渲染文本
Chrome DevTools 元素面板手动验证绑定关系
当 Rich Results Test 报 “No structured data detected”，但代码看起来没问题时，90% 是 itemprop 绑定失效。原因常是：元素没有真实文本内容、被 CSS 隐藏、或父级 itemscope 根本没生效。
操作步骤：
- 右键目标元素（如
<span itemprop="price">¥599</span>）→ “Inspect” - 在 Elements 面板中，确认该元素的
textContent不为空、不含全角空格或 - 向上逐层检查祖先节点，找到最近的带
itemscope的元素，确认其itemtype存在且合法 - 若该
itemprop在<meta>或<link>上，确认content或href属性已正确设置，且值非空字符串
JSON-LD 和 Microdata 切勿混用同一实体
一个产品信息，既在 <script type="application/ld+json"> 里写了 @type: "Product"，又在下方 HTML 里用 itemscope itemtype="https://schema.org/Product" 标了一遍——这不是“双重保险”，而是让 Google 陷入选择困难：两个 Product 实体可能字段不一致（比如价格不同），触发语义冲突警告，甚至整块丢弃。
实操建议：
- 新项目统一用 JSON-LD，放在
<head>内，避免结构耦合 - 遗留 Microdata 页面不要强行补 JSON-LD，优先修复嵌套和文本一致性
- 若必须共存（如第三方评论组件自带 Microdata），确保两者描述的是不同实体（如主产品用 JSON-LD，评论用 Microdata 嵌套在
review字段下）
最易被忽略的点：验证时只看“有没有报错”，却没点开 Preview 看字段值是否和用户看到的一致。哪怕语法全对，itemprop="price" 提取出 “¥599（含税）” 或 “起售价”，也会被降权富摘要资格——结构化数据不是贴标签，是给机器一份可信的、可验证的摘要。
