文章和问答的结构化数据，五个字段最容易写错

结构化数据报错，九成不是 JSON 语法错，是标记的内容和页面可见内容对不上。校验器能过，不等于搜索引擎认。下面五个字段是我们改客户站时最常返工的。

headline

必须和页面 H1 一致，长度控制在 110 个字符以内。常见错法是把 title 标签整串塞进去，带上" | 品牌名"后缀，或者为了关键词硬改 H1。headline 和 H1 不一致，Google 会以页面为准，标记被判无效。

datePublished 和 dateModified

格式必须是带时区的 ISO 8601，比如 2026-01-15T09:00:00+08:00。只写日期也能过校验，但改造过的旧文章如果 dateModified 早于 datePublished，整条标记作废。这两项要和页面上显示的发布时间对得上，别为了"显得新"改日期。

author

文章署名是公司就用 Organization，个人就用 Person，name 必须和页面上署的名字一字不差。我们见过 320 篇文章的 author 全写着 "Admin"，GSC 报告里全报作者无效。

FAQ 主体

Question 的 name 是问题原文，acceptedAnswer 的 text 是答案正文，必须和页面可见的问答内容一致。答案里如果要保留加粗，用受支持的标签，别塞自定义组件。还有一条容易忽略：页面上要有真实的问答区块，不能只在 JSON-LD 里写问答，页面正文根本没有——这属于作弊，会被判垃圾结构化数据。

inLanguage

和页面语言一致。多语言站很容易漏，中文页写了 en，整条标记作废。

怎么查才快

三件事就够了。第一，Rich Results Test 跑单页，直接告诉你哪条字段无效，但它不覆盖全部类型。第二，GSC 的"增强功能"报告按类型汇总全站错误，一次能看几百条，适合批量修。第三，把页面源码里的 JSON-LD 抠出来过一遍 JSON 校验，语法错通常死在这里，比如尾逗号、双引号没转义、时间字段写成中文日期。

我们的做法是把 JSON-LD 做成模板函数，入参是标题、作者、发布时间、封面图，前端统一调用，模板一改全站生效。手写 JSON-LD 的站，改完 300 篇能漏 80 篇。

一个判断

FAQ 的富媒体展示从 2023 年 8 月起就大幅收缩了，普通商业站基本看不到问答展开样式。所以别为了标记硬造问答，页面上本来没有 FAQ 就别加。Article 标记相反，成本低、一直有效，每篇文章都该有。

还有 Organization 和 BreadcrumbList，前者放在全站模板，后者跟着导航走。四类标记，一套模板解决，不用一篇篇手写。