Facebook/Messenger中Deeplink无法自动唤起App，总是跳转至浏览器

核心原因 #

Facebook和Messenger的内置浏览器会拦截常规DeepLink跳转，默认引导至网页端；只有完成官方认可的App-网站关联配置，才会自动触发App唤起逻辑。

具体解决方案 #

1. 配置App Links（官方认可的关联机制）

• Android端：

  • 在AndroidManifest.xml的目标Activity中，添加包含android.intent.category.BROWSABLE的<intent-filter>，确保Scheme和主机名配置正确：

    <activity android:name=".YourTargetActivity">
        <intent-filter android:autoVerify="true">
            <action android:name="android.intent.action.VIEW" />
            <category android:name="android.intent.category.DEFAULT" />
            <category android:name="android.intent.category.BROWSABLE" />
            <data
                android:scheme="your-app-scheme"
                android:host="your-domain.com"
                android:pathPrefix="/your-deeplink-path" />
        </intent-filter>
    </activity>
    

  • 在网站根目录的/.well-known/文件夹下放置assetlinks.json文件，内容示例：

    [{
      "relation": ["delegate_permission/common.handle_all_urls"],
      "target": {
        "namespace": "android_app",
        "package_name": "com.your.app.package",
        "sha256_cert_fingerprints": ["你的App签名SHA256指纹"]
      }
    }]
    

• iOS端：

  • 在Info.plist中添加LSApplicationQueriesSchemes数组，包含你的DeepLink Scheme：

    <key>LSApplicationQueriesSchemes</key>
    <array>
        <string>your-app-scheme</string>
    </array>
    

  • 开启Xcode的Associated Domains功能，添加applinks:your-domain.com
  • 在网站根目录或/.well-known/下放置apple-app-site-association文件，内容示例：

    {
      "applinks": {
        "apps": [],
        "details": [{
          "appID": "TeamID.com.your.app.package",
          "paths": ["/your-deeplink-path/*"]
        }]
      }
    }
    

2. 网页端添加中转跳转逻辑

针对Facebook内置浏览器的拦截特性，在DeepLink对应的网页页面添加JS逻辑，主动触发App唤起：

// 检测是否为Facebook/Messenger内置浏览器
function isFacebookBrowser() {
    const userAgent = navigator.userAgent.toLowerCase();
    return userAgent.includes('fbav') || userAgent.includes('fbios') || userAgent.includes('messenger');
}

// 尝试唤起App，失败则跳转备用链接
function openApp() {
    const deeplinkUrl = 'your-app-scheme://your-deeplink-path';
    const fallbackUrl = 'https://your-domain.com/fallback-page'; // 或App Store/Google Play链接

    if (isFacebookBrowser()) {
        window.location.href = deeplinkUrl;
        // 3秒后检测是否跳转成功，失败则引导至备用页
        setTimeout(() => {
            window.location.href = fallbackUrl;
        }, 3000);
    } else {
        window.location.href = deeplinkUrl;
    }
}

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

3. 使用Facebook官方分享SDK

直接集成Facebook Share SDK或Messenger Sharing API分享内容，SDK会自动处理App唤起逻辑：

• Android：使用ShareDialog并设置ShareLinkContent的setContentUrl为你的App关联网址
• iOS：使用FBSDKShareDialog，配置FBSDKShareLinkContent的contentURL字段

4. 验证配置有效性

• 确保assetlinks.json和apple-app-site-association文件可公开访问（无404错误）
• 检查App签名指纹、TeamID、包名等信息完全匹配
• 在Facebook开发者后台确认App已绑定对应域名

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