OG 标签调试工具
如果你的链接预览为空白或显示错误,首先应该调试页面源代码中的 og 标签。粘贴 HTML 后,工具会准确显示它能读取哪些标签以及每个标签的值,因此缺失或为空的标签会一目了然。
如何调试 og 标签
-
1
使用 view-source
打开页面源代码,而不是浏览器的检查器,然后复制 head。爬虫读取的是原始响应。
-
2
粘贴并运行
粘贴到页面 head HTML 输入框中,点击下一步,然后点击结果。
-
3
找到红色项目
六项检查中每个红色条目,都是工具无法从你的标记中读取的标签。
-
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 在为空时会失败。其他标签只要存在就算通过,因此请阅读显示的值,查看是否有空白。
简短的调试流程
- 粘贴 head,记下红色项目。
- 在模板中修改标记,而不是修改粘贴的副本。
- 重新加载页面,再次复制源代码,并粘贴新版本。
- 重复此过程,直到六项检查全部为绿色,并且显示的值看起来正确。
由于本工具读取的是文本,而不是实时页面,它无法告诉你图片地址是否返回错误,或页面是否发生重定向。请在浏览器中打开 og:image 地址,确认它能够加载。
六项全部为绿色但预览仍然不对
标记可能没有问题,但其他环节出了错。请检查图片地址在浏览器中无需登录即可打开,页面是否会重定向到带有不同标签的其他地址,以及平台是否仍在显示之前抓取的缓存副本。这些原因不在标记之内,工具无法显示,但在这里得到干净的结果,可以把排查范围缩小到这些方面。
常见问题
工具会扫描你粘贴的原始文本,包括 HTML 注释。测试前请删除被注释掉的标签。
结果中每个标签名只显示一个值,即最后找到的那个。请删除重复项,避免产生歧义。
检查器显示的是脚本运行之后的页面。爬虫通常读取原始 HTML 响应,因此调试时应使用 view-source。
不能。它只读取粘贴的标记。它无法看到重定向、被拦截的请求,或加载失败的图片。
相关工具
UTM 链接构建器
使用 UTM 的 source、medium、campaign、term 和 content 参数构建活动跟踪 URL。生成干净、经过 URL 编码的链接,可直接用于广告和电子邮件通讯。
结构化数据标记验证器
粘贴一段 JSON-LD,即刻检查它能否正确解析,并包含 Schema.org 的核心键:@context、@type 以及 name 或 headline,在发布之前完成检查。
站点地图生成器
粘贴你的网址列表,生成带 changefreq、priority 和可选 lastmod 的有效 XML 站点地图,随时保存并提交到 Search Console。
元标签分析器
审计任意URL的元标签,检测缺失标签、长度异常、Open Graph/Twitter值冲突以及机器人指令配置错误等问题。
安全响应头分析器
粘贴你的 HTTP 响应头,即可获得关于关键安全响应头的优先级建议:Content-Security-Policy、Strict-Transport-Security、X-Frame-Options、Referrer-Policy 等。
SERP 预览
在发布前预览谷歌搜索结果。实时字符计数器会提示过长的标题和元描述,谷歌风格的摘要则展示你的结果实际呈现的样子。
此工具还提供其他语言版本
- เครื่องมือดีบัก OG Tags [TH]
- OGタグデバッガー [JA]
- Debugger tagów OG [PL]
- Felsökning av OG-taggar [SV]
- Debugger Tag OG [ID]
- أداة تصحيح وسوم OG [AR]
- OG-Tags-Debugger [DE]
- Depurador de tags OG [PT]
- Công cụ gỡ lỗi thẻ OG [VI]
- Depurador de etiquetas OG [ES]
- OG 태그 디버거 [KO]
- Débogueur de balises OG [FR]
- OG-tags debugger [NL]
- OG Tags Debugger [EN]
- Debugger dei tag OG [IT]
- Отладчик OG-тегов [RU]
- OG Etiketleri Hata Ayıklayıcısı [TR]