OG 标签调试工具

下一步

如果你的链接预览为空白或显示错误,首先应该调试页面源代码中的 og 标签。粘贴 HTML 后,工具会准确显示它能读取哪些标签以及每个标签的值,因此缺失或为空的标签会一目了然。

如何调试 og 标签

  1. 1

    使用 view-source

    打开页面源代码,而不是浏览器的检查器,然后复制 head。爬虫读取的是原始响应。

  2. 2

    粘贴并运行

    粘贴到页面 head HTML 输入框中,点击下一步,然后点击结果。

  3. 3

    找到红色项目

    六项检查中每个红色条目,都是工具无法从你的标记中读取的标签。

  4. 4

    找出原因

    比较显示的值和下方的列表,修复 head,然后重新粘贴。

标签无法被读取的常见原因

如果你在 head 中能看到某个标签,却被报告为缺失,原因几乎都是下列之一:

现象 可能的原因 解决方法
og:title 为红色 标签使用了 name="og:title" 将 name 改为 property
标签缺失,但值看起来没问题 值没有加引号 给 content 的值加上引号
仅在检查器中为红色,但标签确实存在 标签由 JavaScript 添加 在服务器端 HTML 中输出
标签为绿色,但打印出的文字为空 content 属性为空白 填写值
标签被截断或缺失 content 值中包含原始的 > 写成 >
图片显示为 /img/a.jpg 这样的路径 相对地址 使用完整的 https:// 地址

容易误导你的情况

  • 被注释掉的标签仍会被读取。 检查工具扫描你粘贴的文本,因此 HTML 注释中的标签可能显示为绿色,但浏览器或爬虫会忽略它。测试前请删除旧的注释代码。
  • 重复项。 如果同一标签出现两次,列表只显示一个值,即最后找到的那个。请检查 head 中是否有重复项,它们往往来自主题和插件同时添加的标签。
  • 空值。 只有 og:title 和 og:description 在为空时会失败。其他标签只要存在就算通过,因此请阅读显示的值,查看是否有空白。

简短的调试流程

  1. 粘贴 head,记下红色项目。
  2. 在模板中修改标记,而不是修改粘贴的副本。
  3. 重新加载页面,再次复制源代码,并粘贴新版本。
  4. 重复此过程,直到六项检查全部为绿色,并且显示的值看起来正确。

由于本工具读取的是文本,而不是实时页面,它无法告诉你图片地址是否返回错误,或页面是否发生重定向。请在浏览器中打开 og:image 地址,确认它能够加载。

六项全部为绿色但预览仍然不对

标记可能没有问题,但其他环节出了错。请检查图片地址在浏览器中无需登录即可打开,页面是否会重定向到带有不同标签的其他地址,以及平台是否仍在显示之前抓取的缓存副本。这些原因不在标记之内,工具无法显示,但在这里得到干净的结果,可以把排查范围缩小到这些方面。

常见问题

工具会扫描你粘贴的原始文本,包括 HTML 注释。测试前请删除被注释掉的标签。

结果中每个标签名只显示一个值,即最后找到的那个。请删除重复项,避免产生歧义。

检查器显示的是脚本运行之后的页面。爬虫通常读取原始 HTML 响应,因此调试时应使用 view-source。

不能。它只读取粘贴的标记。它无法看到重定向、被拦截的请求,或加载失败的图片。

相关工具

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

使用指南与应用场景