title: "结构化数据的检测与调试：发现schema错误的工具与流程" description: "schema错误或缺失是导致AI不引用您网站的最常见原因。结构化数据检测工具完整指南：Rich Results Test、Schema Markup Validator、Google Search Console以及修复常见错误的方法。" date: "2026-08-09" author: "AEO Saigon" translated: true category: "huong-dan" faqs:

• question: "用哪些工具检测结构化数据？" answer: "按优先顺序列出的3大主要工具：(1) Rich Results Test（search.google.com/test/rich-results）——检测Google识别的schema及是否符合Rich Results条件；(2) Schema Markup Validator（validator.schema.org）——根据schema.org标准检测schema，发现type和property错误；(3) Google Search Console > Enhancements——显示全站schema错误，可提交reprocessing请求。应同时使用三个工具，因为每个工具发现的错误类型不同。"
• question: "最常见的schema错误及修复方法？" answer: "排名前5的错误：(1) Missing required field——缺少必填字段（FAQ需要name和acceptedAnswer，HowTo需要name和step）。修复：添加缺失字段；(2) Wrong @type——使用了错误的子类型。修复：更正@type；(3) 图片尺寸不符——Google要求图片宽度至少1200px，比例16:9。修复：添加带有width/height的ImageObject；(4) datePublished格式错误——必须使用ISO 8601。修复：改为'2026-08-09T08:00:00+07:00'；(5) 重复@id——两个schema使用相同@id。修复：为每个实体设置唯一@id。"
• question: "Schema验证通过但仍没有Rich Result——为什么？" answer: "5个原因：(1) 页面尚未被索引——schema在页面未被索引时无效；(2) 内容与schema不匹配——FAQPage schema但页面主要是产品，schema必须描述真实内容；(3) 政策违规——schema宣传虚假评价或不实优惠；(4) 页面质量低——Google不为低质量页面展示Rich Results；(5) 需要时间——修复后可能需要2-4周让Google重新处理。"
• question: "需要验证每篇博客的schema吗？" answer: "如果使用一致的模板，无需逐篇验证。高效流程：在为模板实现schema时验证一次，然后用Google Search Console监控新错误。只有在以下情况才需要手动验证：添加新类型schema、更改模板或Search Console显示错误激增。" howToSteps:
• name: "使用Rich Results Test检测" text: "访问search.google.com/test/rich-results，输入URL或粘贴HTML源代码。工具显示：识别出的schema、可能的富结果类型（FAQ折叠、评价星级等）、需要修复的错误（红色）和警告（黄色）。查看"Detected structured data"部分，查看Google解析到的所有schema。"
• name: "使用Schema.org Markup Validator验证" text: "访问validator.schema.org，输入URL或直接粘贴JSON-LD。工具检测：@type是否有效、属性是否属于该@type、必需属性是否完整。这里常见的错误：使用了该类型中不存在的属性（例如：使用'rating'而非'aggregateRating'）。"
• name: "使用Google Search Console监控" text: "Search Console > Enhancements显示全站所有schema错误和警告，以及受影响的页面数量。修复流程：点击错误→查看出错URL示例→检查→修复代码→点击'Validate Fix'。设置提醒，当schema错误数激增时接收邮件通知。"
• name: "在浏览器中调试JSON-LD" text: "打开DevTools（F12）→Console，运行JSON解析命令检测页面上的schema。如果无法解析→schema存在JSON语法错误（通常是多余的逗号、错误的引号或未转义的特殊字符）。使用jsonlint.com精确定位错误行。"

Schema错误比您想象的更普遍

通过检测数百个越南网站，超过70%的网站存在至少一个严重的schema错误——而网站所有者完全不知道这些错误，因为页面在用户浏览器中看起来一切正常。

Schema错误不会导致显示错误。它会悄悄地让Google和AI忽略您精心声明的所有结构化数据。结果：没有富结果、不被AI引用、与已正确实施的竞争对手相比失去竞争优势。

好消息是，这些错误都可以在几小时内发现和修复——如果您知道使用正确的工具并有清晰的检测流程。

您需要了解的三大结构化数据检测工具

每个工具发现不同类型的问题——不要只用一个。Rich Results Test可能会遗漏不在Google白名单中的property错误，而Schema Markup Validator则能够发现这些问题。

10大常见schema错误及修复方法

标准FAQPage JSON-LD示例

以下是完整的FAQPage schema示例——这是实践中最容易出错的schema类型：

{
  "@context": "https://schema.org",
  "@type": "FAQPage",
  "mainEntity": [
    {
      "@type": "Question",
      "name": "Schema markup là gì và tại sao quan trọng với AEO?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Schema markup là đoạn code JSON-LD giúp search engine và AI hiểu ngữ nghĩa nội dung website. Khi khai báo đúng, nội dung được hiển thị dưới dạng Rich Results trên Google và được AI trích dẫn chính xác hơn khi trả lời câu hỏi người dùng. Đây là nền tảng của AEO."
      }
    },
    {
      "@type": "Question",
      "name": "Khai báo schema ở đâu trong website Next.js?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "Khai báo trong thẻ script với type='application/ld+json' trong phần head hoặc body của trang. Với Next.js App Router, đặt trong component Script của next/script hoặc trực tiếp trong layout.tsx. JSON-LD dễ bảo trì hơn microdata hoặc RDFa nên được khuyến nghị dùng."
      }
    }
  ]
}

演练：使用Rich Results Test检测schema

第一步： 访问search.google.com/test/rich-results。输入需要检测的页面URL（优先），或者如果页面尚未上线则粘贴HTML源代码。

第二步： 工具处理需要10-30秒。结果显示2个主要区域：

• Eligible rich results: 该页面符合条件的富结果类型列表——FAQ折叠、评价星级、食谱卡片。这是需要达到的目标。
• Detected structured data: Google解析到的所有schema，包括不直接创建富结果的类型。

第三步： 点击"Detected structured data"中的每个schema查看详情。红色错误是缺少必填字段，必须立即修复。黄色警告是缺少推荐字段——应该修复但不是强制要求。

第四步： 对于每个红色错误，工具会显示缺少的property名称。打开代码编辑器，找到该schema并在正确位置添加缺少的property。

第五步： 修复后，直接在Rich Results Test页面使用新代码点击"Test"——无需部署到线上站点再测试。

各类schema的常见错误

Schema不起作用时的5步调试流程

第一步——检查JSON语法： 打开DevTools（F12）→Console，运行命令：

JSON.parse(
  document.querySelector('script[type="application/ld+json"]').textContent
)

如果Console报错，您的schema存在语法错误。使用jsonlint.com精确定位错误行——通常是最后一项后面多余的逗号，或未关闭的引号。

第二步——使用Rich Results Test验证： 检测Google是否识别schema及报告了哪些错误。

第三步——使用Schema Markup Validator验证： 检测Rich Results Test未能发现的property/type错误。

第四步——检查页面索引： 在Google中输入site:domain.com/page-path。如果页面未被索引，schema即使正确也没有效果——必须等待Google抓取。

第五步——等待并请求重新处理： 修复后，进入Google Search Console → URL Inspection → Request Indexing。富结果出现可能需要1-4周。

Search Console监控工作流程

每周安排检查Search Console，重点关注Enhancements（或Rich Results）选项卡。该仪表板显示：

• 每种类型（FAQ、HowTo、Article、Product等）的schema错误页面数
• 随时间的错误增减趋势
• 具体错误名称及受影响的URL数量

当一周内错误数激增时，通常有两个原因：部署新代码破坏了schema模板，或Google更新了该富结果类型的要求。查看Search Console的通知部分，看看Google是否发送了任何消息。

在Search Console中设置邮件提醒，以便在出现新问题时立即收到通知——不要让错误悄悄存在数周才被发现。

部署新schema前的清单

1. 使用jsonlint.com或DevTools Console验证JSON语法
2. 使用Rich Results Test在staging URL或通过HTML粘贴方式检测
3. 在validator.schema.org使用Schema Markup Validator验证
4. 确认所有@id是全站唯一的绝对URL
5. 确认datePublished和dateModified符合ISO 8601格式
6. 确认图片具有width和height（宽度至少1200px）
7. 确认NAP与Google商家资料一致（适用于LocalBusiness schema）
8. 确认schema准确描述页面内容——不声明页面中没有的信息
9. 部署后→在Google Search Console中请求索引
10. 部署后2-4周跟踪Search Console，确认富结果出现