Deep Link适配异常求助：Messenger/Instagram无法唤起APP

问题概述 #

我已为APP配置了Universal Link：

• Android端：配置了AndroidManifest.xml的intent-filter（包含http/https scheme、指定域名与路径前缀），以及/.well-known/assetlinks.json关联文件
• iOS端：添加了applinks:my-domain.com到Associated Domains，配置了/.well-known/apple-app-site-association文件

当前从短信、Slack打开https://my-website.com/app/...可正常唤起APP，使用npx uri-scheme open命令测试Android/iOS端均正常，但从Messenger、Instagram打开时仅跳转至浏览器。已尝试添加Facebook App Links标签但无效，不想改用普通Deep Link（避免流失未下载APP的用户），寻求解决办法。

解决步骤 #

1. 重新验证Facebook App Links配置 #

确保网页的meta标签格式正确，关键标签示例：

<meta property="al:ios:url" content="https://my-domain.com/app/..." />
<meta property="al:ios:app_store_id" content="你的iOS App Store ID" />
<meta property="al:ios:app_name" content="你的APP名称" />
<meta property="al:android:url" content="https://my-domain.com/app/..." />
<meta property="al:android:package" content="com.xx.xx" />
<meta property="al:android:app_name" content="你的APP名称" />
<meta property="al:web:should_fallback" content="true" />

使用Facebook官方的链接验证工具检查配置状态，确保所有标签被正确识别且无错误提示。

2. 针对Facebook系内置浏览器做特殊处理 #

Messenger和Instagram的内置浏览器对Universal Link支持有限，可在网页端通过JS检测环境，尝试用Scheme唤起APP：

function isFacebookBrowser() {
  const userAgent = navigator.userAgent.toLowerCase();
  return userAgent.includes('messenger') || userAgent.includes('instagram');
}

function openApp() {
  if (isFacebookBrowser()) {
    const originalUrl = window.location.href;
    if (navigator.userAgent.includes('Android')) {
      // Android 用Intent唤起
      const intentUrl = `intent://${originalUrl.replace('https://', '')}#Intent;scheme=https;package=com.xx.xx;end`;
      window.location.href = intentUrl;
    } else if (/iphone|ipad/.test(navigator.userAgent.toLowerCase())) {
      // iOS 用自定义URL Scheme唤起（需提前在Info.plist配置，比如myapp://）
      const schemeUrl = originalUrl.replace('https://my-domain.com', 'myapp://');
      window.location.href = schemeUrl;
    }
    // 若唤起失败，3秒后跳回原网页
    setTimeout(() => {
      window.location.href = originalUrl;
    }, 3000);
  }
}

// 页面加载时触发
window.addEventListener('load', openApp);

注意：iOS端需提前在Info.plist中配置自定义URL Scheme，否则无法触发唤起。

3. 清除Universal Link缓存并验证配置有效性 #

• Android端：
  • 确认assetlinks.json可通过https://my-domain.com/.well-known/assetlinks.json直接访问，无重定向，且sha256指纹为APP发布版本的签名指纹（测试版与发布版指纹不同）。
  • 清除APP链接关联缓存：进入Android设置→对应APP→默认打开方式→清除关联后重新测试。
• iOS端：
  • 确认apple-app-site-association文件的Content-Type为application/json，无重定向，App ID格式为「TeamID.BundleID」（例如ABCDE12345.com.xx.xx）。
  • 重置Universal Link缓存：删除APP后重新安装，或切换飞行模式再关闭。

4. 避免Facebook对链接的转码处理 #

• 分享到Messenger/Instagram的链接使用原始链接，避免通过短链接服务转码。
• 若使用Facebook开发者平台，将域名添加到APP的「允许域名」列表中，防止链接被Facebook修改导致Universal Link失效。

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