链接预览修复指南

您的链接没有显示图片、标题有误,还是显示的是旧卡片?请在下方选择对应的应用或建站工具。每篇指南均涵盖了原因排查、相关标签、图片规则以及如何强制刷新的方法。

应用与平台

领英 (LinkedIn) 链接预览无法显示或未更新

领英(LinkedIn)根据四个 og: 标签生成预览卡片并保留缓存副本。修复这些标签后,使用 Post Inspector 让领英重新抓取该页面。

Facebook 链接预览不显示或未更新

Facebook 会使用自己的爬虫抓取 Open Graph 标签,并将结果缓存长达 30 天。请修正标签和图片,然后重新抓取该网址。

WhatsApp 链接预览无法正常工作或未显示

WhatsApp 限制十分严格:head 必须位于 HTML 的前 300 KB 内,且图片大小必须在 600 KB 以下。只要漏掉其中一项,您就只能看到小图预览,甚至完全没有预览。

iMessage 链接预览无法正常工作或显示灰色气泡

“信息”应用会自行抓取网页,且不会运行 JavaScript。如果没有设置 og:image 和精美的图标,就只会显示一个仅带标题的普通灰色气泡。

Slack 链接预览无法正常工作或未更新

Slack 通过机器人读取 oEmbed、Open Graph 和 Twitter Card 标签来展开链接预览。抓取结果会在 Slack 中缓存约 30 分钟。

Discord 嵌入内容未显示或未更新

Discord 会抓取该页面一次,读取服务器 HTML 中的标签,并将嵌入内容缓存约 30 分钟。它绝不会运行您的 JavaScript。

X (Twitter) 卡片未显示或未更新

X 会优先根据 twitter: 标签生成卡片预览,如果不存在则会回退使用 og: 标签。现在已经不再提供可以刷新缓存的验证工具了,因此解决方法就是配置正确的标签,并使用一个全新的 URL。

先修复页面,然后清除缓存

每篇指南都遵循相同的顺序。首先确保页面上的标签和图片正确无误。然后再让应用重新抓取,否则它会再次保存错误的版本。

请先检查标签

大多数预览显示异常都是由于缺少 og:image、使用了相对图片路径或标签是由 JavaScript 动态添加导致的。Discord 和 iMessage 不会运行 JavaScript,因此这些标签必须直接包含在服务器返回的 HTML 中。

查看图片

请使用尺寸为 1200 x 630 像素、大小在 5 MB 以内且带有绝对 https:// 网址的 JPG 或 PNG 图片。这能满足本指南中所有应用的最低尺寸要求。此外,WhatsApp 要求其大小须在 600 KB 以内。

然后清除缓存

每个应用都会保留自己的预览副本。修改页面后,只有在应用重新获取该页面时,预览内容才会更新。

链接预览常见问题

为什么我的链接预览没有显示?

该应用程序可能无法读取您的标签,或者仍在显示之前保存的副本。请使用元标签检查器查看您的页面当前提供的内容。如果标签无误,应用程序需要重新获取该页面。

大多数应用会读取哪些标签?

og:title、og:description、og:image 和 og:url 适用于 LinkedIn、Facebook、WhatsApp、iMessage、Slack 和 Discord。X 会优先读取 twitter:card,其余内容则回退使用 og: 标签。

如何让应用重新获取我的页面?

LinkedIn 拥有 Post Inspector,Facebook 则有 Sharing Debugger。大多数其他应用没有刷新工具,因此你需要分享一个它们从未见过的网址,比如在同一个链接末尾加上 ?v=2。