速查在线工具箱结构化数据写了却没有富摘要，最常见的错误是哪些？
语法没错只是及格线——类型对不对、必填字段齐不齐、值格式合不合规，才决定会不会展示。
按可能性从高到低排查：一是类型选错，页面是文章却写了 Product，或把 Article 与 NewsArticle 用混；二是必填字段缺失，例如文章类缺 author、面包屑类缺 itemListElement；三是字段值格式不合规，最常见的是日期写成了 2026/10/08 这种斜杠格式，以及 image、url 这类字段用了相对路径而不是完整的 https 地址。
还有两个前提条件经常被忽略。第一，结构化数据不能替代收录：页面本身没有被索引，富摘要自然无从显示。第二，不是所有类型都还在提供富摘要——部分类型已经下线，写了也不会展示。所以「代码通过校验」和「搜索结果里出现富摘要」之间，还隔着收录与类型可用性两道门。
结构化数据的作用是把页面内容翻译成机器能直接读懂的字段，帮搜索引擎判断「这是什么、包含什么信息」，从而在搜索结果里用更丰富的形式展示。它的语法门槛很低，但生效条件比想象中多。
很多站点的情况是：代码写得没错，校验工具也通过了，可搜索结果的展示形式毫无变化。这时候继续改代码方向就错了，应该按下面三类硬伤逐条排查。
1三类高频错误
按出现频率排列。前两类属于「写了但写得不对」，第三类属于「对了但机器读不懂」。
| 类型 | 典型表现 | 修法 |
|---|---|---|
| 类型选错 | 文章页写了商品类型，或该用子类型时用了父类型 | 按页面实际内容选类型，子类型优先 |
| 必填字段缺失 | 文章类缺作者，面包屑类缺条目列表 | 对照该类型的必填字段逐个补齐 |
| 日期格式不合规 | 写成斜杠分隔，或只写到月份 | 改成标准日期格式，带时间时补上时区 |
| 图片与网址用相对路径 | 写成以斜杠开头的站内路径 | 改成完整地址，含协议头与域名 |
| 作者只写了名字 | 作者字段是纯字符串而非对象 | 改成带类型标注的对象，例如人物或组织 |
| 内容写在标签外 | 把代码块贴到了页面其他地方 | 确认结构化数据位于页面头部区域 |
最后一行看起来低级，却相当常见：把代码贴到了页面主体里，页面照样渲染，但抓取时可能不被正确处理。结构化数据应当放在页面的头部区域。
2常用类型的必填字段
不同类型的必填项不一样。缺其中任何一项，通常都不会展示富摘要，而校验工具未必会报错。
| 类型 | 必填字段 | 适用页面 |
|---|---|---|
| Article 及其子类型 | 标题、发布时间、作者 | 资讯、博客、教程 |
| BreadcrumbList | 面包屑条目列表 | 带层级导航的任意页面 |
| Product | 商品名称、报价信息 | 商品详情页 |
| WebSite | 站点名称、站点地址 | 首页 |
| WebApplication | 应用名称、页面地址 | 在线工具页 |
| VideoObject | 视频名称、缩略图、上传时间 | 视频详情页 |
| Organization | 名称、官网地址 | 品牌或公司介绍页 |
| Event | 活动名称、开始时间、地点 | 活动详情页 |
用「子类型优先」原则：文章是博客就写 `BlogPosting`，是新闻就写 `NewsArticle`，都比笼统的 `Article` 更准确。类型写得越具体，机器越容易判断该用哪种展示形式。
3多个节点怎么写
一个页面往往同时需要文章信息和面包屑，这时用图结构把多个节点放进同一个数据块，而不是在页面里散落多个互不相关的数据块。
- 用图结构组织
- 一个数据块里用节点数组承载多个类型，共享同一个上下文声明
- 上下文可继承
- 顶层声明一次之后，子节点可以不再重复声明
- 类型可并列
- 一个节点同时属于多个类型时，类型字段可以用数组
- 跨节点引用
- 用标识符互相引用，避免把同一份信息重复写两遍
- 逐节点校验
- 节点多了之后，错误会分散在不同节点里，必须逐个检查
- 不要漏掉上下文
- 每个数据块都要能追溯到上下文声明，否则整体不被识别
4写完之后的检查顺序
顺序很重要：先保证能读，再保证写对，最后才谈展示。
- 第一步查语法：确认是合法数据格式，没有多余逗号、括号配对正确。
- 第二步查类型：页面是什么内容就写什么类型，子类型优先。
- 第三步查必填：对照该类型的必填字段表逐个核对，不要漏。
- 第四步查取值格式：日期、时间、网址、图片地址是否都是规范格式。
- 第五步查一致性：结构化数据里的标题是否与页面标题一致，避免两处打架。
- 第六步确认收录：页面能被正常抓取和索引，才谈得上展示。
- 第七步确认类型仍可用：部分类型已经不再提供富摘要，写了也不会有变化。
- 第八步用官方测试工具复核：工具能给出抓取结果与可用功能提示，比本地校验更接近真实情况。
顺着这个问题往下用
全部工具总览 →相关疑问
语法校验通过了就一定会显示富摘要吗？
不会。语法校验只说明这段数据能被解析，是必要条件而不是充分条件。要展示富摘要，还要满足必填字段齐全、取值格式规范、页面被正常收录、该类型当前仍提供富摘要这几个条件。四个条件缺一个，结果都是「代码没问题，但什么也没变」。
日期到底该写什么格式？
按标准写法：只有日期时写成四位年、两位月、两位日，中间用短横线分隔；带时间时在日期后面用字母 T 连接，末尾补上时区偏移。容易出错的是用斜杠分隔，或者月份与日只写一位数字。
为什么图片地址不能用相对路径？
因为结构化数据的消费者不一定是在你的页面上下文里解析这些地址。相对路径会让它无法确定完整位置，于是这条信息被视为无效。凡是网址类的字段，都写成包含协议头与域名的完整地址最稳妥。
写多个类型会不会互相冲突？
不会，只要组织得当。同一个页面同时描述文章与面包屑是很常见的需求。做法是把它们放在同一个数据块里，用图结构承载多个节点，共享上下文声明。真正会造成问题的，是在页面里散落多个互不相关、又各自声明上下文的数据块。
继续看：相关问题与资料
全部问题解答 →内容说明：本页针对具体使用问题作答，方法步骤与数值由本站自行整理与复算，事实性内容以对应官方规范与文档为准。内容最后核对日期：2026-10-08。若发现错误，欢迎通过页脚反馈入口告知。