Android端Branch.io链接分享至WhatsApp/Facebook时图片偶现不显示问题

我碰到过不少开发者遇到这个Branch.io链接分享预览不稳定的问题，结合你的代码和平台特性，给你几个针对性的解决思路：

1. 补全BranchUniversalObject的图片配置（你的代码缺了关键项） #

从你贴的代码来看，没有设置canonicalImageUrl——这是平台抓取预览图的核心依据！必须添加公开可访问的HTTPS图片链接，而且要直接指向图片文件（不能是跳转页面）。

示例补充代码：

// 关键：添加符合要求的图片链接
buo.setCanonicalImageUrl("https://your-public-domain.com/path/to/your-image.jpg");

注意：图片尺寸要匹配平台要求：WhatsApp推荐至少300x200px，Facebook推荐1200x630px的大图，比例不对或尺寸太小可能被平台忽略。

2. 确保图片链接的可访问性 #

平台的爬虫（比如WhatsApp的WhatsApp/2.23.10.72 UA、Facebook的facebookexternalhit/1.1 UA）需要能直接抓取到图片：

• 必须用HTTPS链接，HTTP链接大概率会被拦截
• 检查图片存储服务（比如OSS、Firebase Storage）的防盗链设置，要允许这些爬虫UA访问
• 不要用临时链接或者带过期时间的签名链接，爬虫抓取时可能已经失效

3. 强制Branch刷新链接元数据，避免缓存干扰 #

Branch会缓存链接的元数据，有时候修改了内容但旧缓存还在生效。生成链接时可以强制刷新：

LinkProperties linkProperties = new LinkProperties();
// 强制Branch重新生成链接的元数据
linkProperties.setForceLinkRefresh(true);
// 可以指定分享渠道，帮助Branch优化预览
linkProperties.setChannel("whatsapp"); // 或者"facebook"

// 生成链接时传入这个LinkProperties
buo.generateShortUrl(context, linkProperties, new BranchLinkCreateListener() {
    @Override
    public void onLinkCreate(String url, BranchError error) {
        if (error == null) {
            // 拿到链接后执行分享逻辑
        }
    }
});

4. 绕过WhatsApp/Facebook的本地缓存 #

这两个平台都会缓存链接预览内容，哪怕你更新了Branch的元数据，平台可能还显示旧的预览。测试时可以在链接末尾加随机参数绕过缓存：
比如把生成的链接改成 https://your-branch-link.com/xxx?v=123（每次测试换不同的v值）

5. 验证链接的OG元数据 #

你可以通过Branch后台的链接验证工具，查看链接返回的HTML中og:image、og:title等标签是否正确。如果标签里的图片链接不对，平台肯定无法显示预览。

最后给你补全后的完整示例代码：

BranchUniversalObject buo = new BranchUniversalObject();
buo.setCanonicalIdentifier(itemMap.get(Constants.TAG_ID));
buo.setTitle(itemMap.get(Constants.TAG_TITLE));
buo.setContentDescription(des);
// 补充图片链接
buo.setCanonicalImageUrl("https://your-public-domain.com/path/to/valid-image.jpg");
buo.setContentIndexingMode(BranchUniversalObject.CONTENT_INDEX_MODE.PUBLIC);

// 完善元数据（你的代码里的addCustomMetadata可以继续补充）
ContentMetadata contentMetadata = new ContentMetadata();
contentMetadata.addCustomMetadata("item_id", itemMap.get(Constants.TAG_ID));
buo.setContentMetadata(contentMetadata);

// 设置链接属性，强制刷新
LinkProperties linkProperties = new LinkProperties();
linkProperties.setForceLinkRefresh(true);
linkProperties.setChannel("whatsapp");

// 生成并分享链接
buo.generateShortUrl(context, linkProperties, new BranchLinkCreateListener() {
    @Override
    public void onLinkCreate(String url, BranchError error) {
        if (error == null) {
            // 执行分享到WhatsApp/Facebook的逻辑
        } else {
            // 处理链接生成错误
        }
    }
});

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