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

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

最后更新

快速修复


  1. 使用元标签检查器检查页面。

  2. 将 og:image 设置为小于 600 KB 且宽度至少为 300 像素的文件的绝对 URL。

  3. 确保 og:title、og:description 和 og:url 已填写并位于 head 内。

  4. 将 URL 粘贴到聊天中,等待 10 秒并在发送前检查预览。


为什么 WhatsApp 预览缺失或显示过小

  • 图片文件过大。WhatsApp 要求图片大小在 600 KB 以下。大多数其他平台允许的文件大小要大得多,因此这是最常见的原因。

  • head 标签位置过于靠后。包含标签的 <head> 必须出现在 HTML 的前 300 KB 内容中。

  • 标签为空或位于 head 之外。og:title、og:description 和 og:url 必须位于 head 内且不能为空。

  • 图片过窄或过宽。其宽度应为 300 像素或更宽,宽高比应在 4:1 或以内。

  • 图片 URL 是相对路径。og:image 必须是绝对 URL。

如何修复

  1. 在 meta 标签检查器 中打开页面,确认四个 og: 标签。

  2. 将图片压缩至 600 KB 以下。通常 1200 x 630 的 JPG 图片大小合适。可使用 OG 图片尺寸检查器 进行检查。

  3. 将脚本和大型内联代码移至标签下方,以使 head 保持在页面的前 300 KB 之内。

  4. 将 og:url 设置为干净的规范(canonical)URL,不包含任何跟踪或会话参数。

  5. 将链接粘贴到新消息中并等待。如果 10 秒后仍未出现预览,则说明上述规则中仍有一条未满足。

WhatsApp 读取的标签

  • og:title 加粗显示,最多 2 行,不包含品牌信息

  • og:description 字体较小,显示 1 或 2 行;80 个字符即可

  • og:url 规范 URL

  • og:image 缩略图

图片尺寸规则

  • 小于 600 KB

  • 宽度至少为 300 像素

  • 宽高比为 4:1 或更小

  • 绝对 URL

如何强制刷新

WhatsApp 没有刷新工具。发送带有查询字符串(例如 ?v=2)的 URL,使其作为新链接抓取页面。已发送的消息将保留其原有预览。刷新工具在其他平台旁边列出了此步骤。

未经验证:WhatsApp 未公布其缓存预览的时长。有些指南称 Facebook 的 Sharing Debugger 也可以刷新 WhatsApp;但 WhatsApp 的官方文档并未这样说明,且其抓取工具使用的是自有的 WhatsApp User-Agent。

来源

常见问题

WhatsApp 的链接预览需要多大尺寸的图片?

小于 600 KB,宽度至少为 300 像素,且长宽比不得超过 4:1。URL 必须是绝对路径。

为什么 WhatsApp 显示的是小预览图而不是大预览图?

该图片不符合尺寸规范,因此 WhatsApp 会自动切换为小图预览。请先将其压缩至 600 KB 以下。

如何刷新 WhatsApp 链接预览?

没有官方工具。您可以分享带有查询字符串(如 ?v=2)的网址。尚未证实:WhatsApp 并未公开其缓存时间。

检查您的页面,然后刷新预览

将您的网址粘贴到免费检查器中,查看各个应用程序读取的具体标签。标签确认无误后,使用刷新工具清除旧的预览。