Schema 标记 10 大常见错误与排查修复清单

2026-09-13 · 谷歌SEO

结构化数据的报错九成是重复的：不是 JSON 语法错误，就是类型没选对、字段没填全。这篇文章把 Schema 标记最常见的 10 个错误集中列出，每个都带现象、原因和修复方法，可以直接当排查手册用。想从源头避免手写错误，用 Schema 结构化数据生成器生成代码。

错误一：JSON 语法错误（尾逗号/漏引号）

现象：Rich Results Test 直接报"无效 JSON"。原因：手写时丢了引号、多写了尾逗号。修法：用生成器生成；手改时每改一处就重新跑一遍测试。想彻底看懂 JSON 结构可先读 JSON-LD 格式详解。

错误二：没有 @context 或写错词汇表

现象：Validator 提示无法识别类型。原因：少了 "@context": "https://schema.org"。修法：最外层第一行补上，注意是 schema.org 而不是 schemas.org。

错误三：@type 选错或写错大小写

现象：测试工具检测不到富结果类型。原因：如 FAQ 内容用了 Article，或把 faqpage 写成了小写。修法：类型名严格按 schema.org 的大小写（FAQPage、BreadcrumbList），内容与类型要匹配；FAQ 与 Article 的适用差异见 FAQ Schema 教程。

错误四：必填字段缺失

现象：富结果"缺少必填字段"。原因：如 Product 没有 offers、Article 没有 headline。修法：按各类型的必填清单补全（Product 的 offers 必填说明见 Product Schema 指南）。

错误五：相对路径与错误 URL

现象：测试提示图片/链接无效。原因：写了 /images/a.jpg 或域名拼写有误。修法：全部改成完整绝对地址，逐个复制粘贴避免手打。

错误六：日期格式不符合 ISO 8601

现象：datePublished 不识别。原因：写了"2026 年 9 月 13 日"或"今天"。修法：写 2026-09-13T08:00:00+08:00 这样的完整时间戳。

错误七：FAQ 内容对用户不可见

现象：FAQPage 不展示折叠面板。原因：页面没有真实的问答区块，只有代码声明。修法：页面正文补上与声明一致的 FAQ 区块——声明的内容必须可见可用。

错误八：评分/价格与现实不一致

现象：标记被移除或零展示。原因：虚构评分、虚标库存、币种写错。修法：只填真实数据，库存状态与页面、后台保持一致（独立站尤其注意，见跨境电商 Schema 应用清单）。

错误九：全站复用同一段代码

现象：多页面出现相同的 headline/价格，Search Console 提示重复。原因：复制粘贴后没改字段。修法：每页生成独立的代码，即使模板自动化也要按页面注入变量。

错误十：部署到错误的标签或位置

现象：源码里能看到 JSON 但测试没检测到。原因：没用 script type="application/ld+json" 包裹，或代码被注释掉。修法：确认标签类型正确、位于 <head> 或 <body> 内且未被注释。

排查顺序建议

一次报错可能是多个原因叠加，建议按这个顺序排查：

先查语法（错误一/二）→ 再查类型（错误三/六）→ 再查必填字段（错误四）
→ 再查 URL 与图片（错误五）→ 最后查内容一致性（错误七/八）

修完一轮重新测试，通常 1-2 轮就能清零（完整验证流程见 Schema 验证全流程）。

修查一体：把清单变成自己的检查习惯

这份 10 条清单的价值在于形成"肌肉记忆"：每次配完 Schema，心里过一遍这 10 条，绝大多数低级错误当场就能排除。不用背原文，记住三个关键词即可：语法、类型、一致性。

语法对应错误一、二、六（JSON 合法性、词汇表、日期格式）；类型对应错误三、九（类型选择、代码重复）；一致性对应错误五、七、八、十（URL、内容可见、数据真实、部署位置）。按这三个词回忆，比硬背数字靠谱。

真正解决不了的疑难，再交给 Rich Results Test 和官方 Validator 定位，工具会给出明确的字段级提示。先自查后工具，通常一轮就能通关。

小结

10 个常见错误里，绝大部分都能靠"生成器生成 + 测试工具验收"消灭，剩下的"内容一致性"类错误靠真实运营守住底线。收藏这份清单，排查时逐条对照即可。现在就用工具规避手写坑： → 打开 Schema 生成器，从源头避免语法与字段错误。