WhatsApp桌面浏览器分享链接OG图片及描述不显示排查

一、先修正现有OG标签的不规范配置 #

WhatsApp移动端对OG标签的容错度远高于桌面端，你当前的标签存在多处不符合OG协议规范的问题，桌面端解析器会直接丢弃违规字段，导致预览失效：

• og:type 配置错误：该字段仅接受固定枚举值，常规站点填website即可，你当前填入的业务介绍类内容不属于合法值，会直接打断整个OG字段的解析流程。
• OG图片尺寸不达标：你配置的图片尺寸为300300px，WhatsApp桌面端要求OG图最小尺寸为600315px，推荐使用1200*630px的图片，过小的图片移动端可降级展示，桌面端会直接判定为无效资源拒绝加载。
• 存在非标准冗余字段：og:image:secure不属于官方OG属性，HTTPS站点只需将og:image配置为可正常访问的HTTPS地址即可，多余的非标准字段会干扰桌面端解析器的字段识别逻辑。
• 无效占位值干扰：og:site_name填的@website、fb:admins填的Author都是无效占位内容，不符合字段值要求，可能触发桌面端解析器的拦截规则。

二、桌面端特有问题排查 #

修正配置后如果仍无法正常展示，按以下顺序排查桌面端独有的机制问题：

• 独立缓存问题：WhatsApp桌面端和移动端的链接预览缓存完全独立，不会同步移动端的抓取结果，且桌面端缓存过期时间更长。修改配置后不要短时间内反复发同一条链接测试，否则会直接命中旧缓存，至少间隔10分钟以上再测试。
• 爬虫UA被拦截：WhatsApp桌面端抓取页面的UA标识和移动端不同，如果你服务器配置了WAF、反爬规则、UA黑白名单，拦截了桌面端爬虫的请求，就会导致桌面端拿不到页面内容无法生成预览，移动端UA未被拦截所以展示正常。直接查服务器访问日志，确认来自WhatsApp桌面端的抓取请求是否返回200状态码，有没有被跳转、返回403/404/5xx错误的情况。
• 图片加载校验不通过：桌面端对OG图的校验规则比移动端严格：
  • 图片不能配置防盗链拦截，要允许WhatsApp爬虫直接拉取
  • 图片响应头要配置正确的CORS跨域允许规则
  • 图片文件大小控制在1MB以内，过大的图片桌面端会超时放弃加载，移动端对大文件的超时容忍度更高
  • 优先使用标准基线JPG格式，渐进式JPEG、WebP等格式在部分旧版桌面客户端存在兼容问题
• 客户端兼容问题：旧版Electron架构的WhatsApp桌面客户端、网页版WhatsApp存在已知预览解析bug，HTTP/2协议站点、配置了严格CSP安全策略的站点可能出现预览加载失败，升级到最新版官方客户端测试即可排除该问题。

三、验证注意事项 #

修改完配置后先确认页面源码中OG标签已更新，不要直接在正式会话发链接测试，可发给自己的账号或者文件传输类测试会话，避免频繁触发缓存拦截。

内容的提问来源于stack exchange，提问作者Yogesh Bangar