结构化数据标记验证器

下一步

几乎能通过验证的结构化数据,往往就是悄无声息地无法生成丰富结果的结构化数据。把你的 JSON-LD 代码块粘贴到这里,本验证器会立刻确认两件事:它能否解析为有效的 JSON,以及它是否包含每个 Schema.org 项目都需要的要素:一个 @context、一个 @type,以及一个 nameheadline。可以把它当作你在运行较慢的富媒体搜索结果测试之前所做的快速结构检查:几秒钟内就能找出漏掉的括号或缺失的类型。

如何检查你的结构化数据标记

  1. 1

    粘贴你的 JSON-LD

    放入完整的 `<script type="application/ld+json">` 代码块,或只放其中的 JSON 对象:script 标签会被自动去除。

  2. 2

    运行检查

    验证器会解析 JSON;如果无法解析,会指出需要修复的确切语法错误。

  3. 3

    查看结果

    它会确认核心键是否齐全(`@context`、`@type` 以及 `name` 或 `headline`),或精确列出缺少哪些。

  4. 4

    修正后再次检查

    修正代码片段并反复运行,直到结果干净为止,然后再拿去 Google 的富媒体搜索结果测试,检查各类型专属的规则。

常见验证错误及解决方法

当你把标记提交给 Google 富媒体搜索结果测试这类完整验证器时,大多数失败都源于同一份简短的错误清单。学会识别它们能显著缩短调试时间。

常见问题

错误消息 含义 解决方法
缺少 “image” 字段 省略了必填字段 至少添加一个图片 URL(绝对路径)
“datePublished” 不是有效日期 格式错误 使用 ISO 8601:2026-04-18,或带时间与时区偏移
未知类型 “Offers” 大小写错误 offers 数组内使用 Offer(单数)
缺少必填字段 “price” 产品没有价格 在 offers 中添加 pricepriceCurrency
“author” 的值是字符串 应为 Person/Organization 对象 包装成 { "@type": "Person", "name": "..." }
重复的 @id 两个节点上有相同的标识符 每个实体使用唯一的 @id
reviewCount 为 0 却带 aggregateRating 星级摘要至少需要 1 条评价 移除评分,或等有评价后再加
URL 为 “/”(相对路径) 解析器要求绝对 URL 使用完整的 https://example.com/path

警告与错误的区别

  • 错误表示富媒体结果不合格,请先修复。
  • 警告表示合格,但缺少某个能解锁更大摘要的属性(例如给 Product 加上 brandsku)。

可靠标记的实用技巧

  • 先做结构检查,再做深度验证。 在这里修好一个断裂的括号或缺失的 @type,能省去一趟较慢的、各类型专属工具的往返。
  • 让标记与内容保持同步。 更新页面标题却不更新 headline,是最快被判定为不一致的方式。
  • 优先使用 JSON-LD 以便维护:单个代码块比散落在 HTML 各处的属性更容易检查。
  • 关注 Search Console。 Google 会按类型记录结构化数据的错误与改进,请每月查看一次。

常见问题

不能:这只意味着你的 JSON-LD 格式规范且带有核心键。富媒体结果还需要各类型专属的必填属性、与标记真正相符的内容,以及 Google 的质量门槛。用它快速修好基础,然后到 Google 的富媒体搜索结果测试中确认是否合格。

这是一项轻量的结构检查:它确认 JSON 能否解析,以及 @context@typenameheadline 是否存在。Google 的测试则更进一步,会校验每种合格类型的必填属性。先运行本工具清除明显错误,再用 Google 的测试检查各类型专属的规则。

可以:粘贴完整的 <script type="application/ld+json">…</script> 代码块,或只粘其中的 JSON 对象。外层的 script 标签会在解析前被去除。每次验证一个代码块。

不会。代码片段仅被发送到我们的服务器以运行检查,随后立即丢弃;你粘贴的任何内容都不会被保存。

相关工具

此工具还提供其他语言版本