如何在WordPress博客部署Schema Markup及排查显示异常问题

1. 检查Schema代码的包裹容器 #

Schema标记必须放在<script type="application/ld+json">标签内，且要确保标签闭合正确。如果直接把JSON代码裸写在HTML里，浏览器会把它当成普通文本输出。

• 正确格式示例：

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "BlogPosting",
  "headline": "你的博客标题",
  "image": "图片URL",
  "video": {
    "@type": "VideoObject",
    "contentUrl": "视频URL"
  }
}
</script>

• 错误情况：没有<script>标签包裹，或者标签类型写错（比如写成text/javascript）。

2. 验证HTML语法正确性 #

• 检查Schema代码所在位置的HTML结构，是否存在未闭合的标签（比如前面的<div>、<header>没闭合），导致浏览器解析错乱，把脚本内容当成文本渲染。
• 用HTML验证工具扫描整个页面，定位语法错误点。

3. 确认Schema代码的放置位置 #

Schema标记应该放在<head>标签内，或者页面<body>的末尾，避免和页面内容的HTML元素混淆。如果放在<header>的可见内容区域，很容易被当成页面文本显示。

4. 验证Schema代码的JSON格式 #

即使标签正确，JSON语法错误也可能导致解析异常（比如逗号遗漏、引号不匹配、属性名未加引号）。可以用JSON校验工具检查代码的语法正确性，确保没有格式错误。

5. 检查CMS或建站工具的集成方式 #

如果你是用CMS或建站工具添加的Schema，可能是插件/工具的配置错误：

• 有些插件会要求选择代码注入的位置，误选了“页面头部可见区域”而非“HTML头部”。
• 手动添加代码时，是否在编辑器的“文本模式”而非“可视化模式”下粘贴，避免编辑器自动转义引号或添加多余标签。

完成以上排查后，用Rich Results Test工具检测页面，确认Schema是否被正确识别，同时刷新页面查看前端是否还显示代码文本。

内容的提问来源于stack exchange，提问作者Haseeb Ahmed