Firebase动态链接getDynamicLink()调用时机与重复触发问题求助

我之前也遇到过一模一样的问题，这其实是Activity生命周期特性+Intent数据残留共同导致的，咱们一步步拆解解决：

问题根源分析 #

• 放在onCreate的问题：当应用在后台运行时，MainActivity的实例已经存在，点击Deep Link不会重新创建Activity，自然不会触发onCreate，所以代码没机会执行，无法获取链接。
• 放在onStart的问题：onStart每次Activity变为可见都会调用，当用户从打开的详情页返回MainActivity时，onStart再次触发，而原来的Intent里还保留着Dynamic Link的数据，导致getDynamicLink再次拿到链接，重复执行处理逻辑。

最优解决方案：结合onCreate+onNewIntent，并清除Intent数据 #

我们需要覆盖**冷启动（应用未运行）和热启动（应用在后台）**两种场景，同时处理完链接后清除Intent里的残留数据，避免重复触发。

1. 创建通用的链接处理方法

先把Dynamic Link的处理逻辑封装成一个方法，方便复用：

private void handleFirebaseDynamicLink() {
    FirebaseDynamicLinks.getInstance()
        .getDynamicLink(getIntent())
        .addOnSuccessListener(this, pendingDynamicLinkData -> {
            // 检查是否拿到有效链接
            if (pendingDynamicLinkData != null) {
                Uri deepLink = pendingDynamicLinkData.getLink();
                if (deepLink != null) {
                    // 这里写你的链接处理逻辑，比如跳转对应页面
                    // 示例：startActivity(new Intent(this, TargetActivity.class).setData(deepLink));
                    
                    // 关键：处理完链接后，清除Intent中的数据，防止重复触发
                    setIntent(new Intent());
                }
            }
        })
        .addOnFailureListener(this, e -> Log.w(TAG, "处理Dynamic Link失败", e));
}

2. 在生命周期方法中调用处理逻辑

在onCreate处理冷启动场景，在onNewIntent处理后台唤醒场景：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    // 处理冷启动时的Dynamic Link
    handleFirebaseDynamicLink();
}

@Override
protected void onNewIntent(Intent intent) {
    super.onNewIntent(intent);
    // 更新当前Activity的Intent为最新的（后台唤醒时的新Intent）
    setIntent(intent);
    // 处理后台唤醒时的Dynamic Link
    handleFirebaseDynamicLink();
}

3. 配置Activity启动模式

确保你的MainActivity在AndroidManifest.xml中设置为singleTask启动模式，这样后台唤醒时会复用已存在的实例并触发onNewIntent：

<activity
    android:name=".MainActivity"
    android:launchMode="singleTask">
    <!-- 你的Dynamic Link意图过滤器 -->
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data
            android:scheme="https"
            android:host="你的动态链接域名（比如xxx.page.link）" />
    </intent-filter>
</activity>

为什么这样有效？ #

• 冷启动时，onCreate执行，处理链接后清除Intent，后续返回不会重复触发。
• 后台运行时，点击链接触发onNewIntent，更新Intent后处理链接，同样清除Intent数据。
• singleTask模式保证了后台的MainActivity不会被重新创建，而是直接唤醒并调用onNewIntent。

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