iOS端Branch.io动态链接缩略图不显示问题求助

针对你的情况，以下是几个排查和解决的方向：

1. 检查图片URL的合规性 #

• 必须使用HTTPS协议：多数社交平台（包括WhatsApp）不支持HTTP图片作为缩略图。
• 图片尺寸符合要求：Branch推荐缩略图至少为1200x630像素（宽高比1.91:1），避免使用过小或非标准比例的图片。
• 图片格式与大小：确保是JPG/PNG格式，文件大小控制在500KB以内，过大的图片可能被爬虫或平台拒绝。

2. 确认图片可被Branch爬虫抓取 #

部分服务器会设置防盗链规则，阻止Branch的爬虫获取图片。你可以：

• 用curl模拟Branch爬虫请求，检查是否能正常获取图片：

  curl -A "BranchBot/1.0" [你的图片URL]
  

• 如果返回403或无法访问，需要在服务器端允许BranchBot/1.0这个User-Agent的请求。

3. 强制刷新Branch的元数据缓存 #

Branch会缓存链接的元数据，如果你之前生成过无图片的链接，缓存可能没更新。可以在BranchLinkProperties中添加强制忽略缓存的参数：

let blp: BranchLinkProperties = BranchLinkProperties()
blp.channel = "whatsapp"
blp.feature = "Product Sharing"
// 添加这行强制刷新缓存
blp.addControlParam("$ignore_cache", "true")

4. 验证链接元数据 #

生成链接后，用Branch后台的Link Debugger工具检查元数据是否正确抓取。如果工具里显示图片加载失败，说明是图片本身或爬虫访问的问题；如果工具里显示正常但社交平台不显示，可能是平台自身的缓存，需要等待一段时间（或换个测试设备）。

5. 检查BranchUniversalObject的配置细节 #

确保contentDescription不为空，部分平台需要完整的标题、描述和图片三元组才会显示缩略图。另外，确认publiclyIndex设置为true，这个参数允许Branch爬虫抓取元数据。

内容的提问来源于stack exchange，提问作者Ayan Ansari