FlutterFire Dynamic Links无法被Android应用接收问题求助

针对你遇到的点击邮箱动态链接能打开App，但getInitialLink()返回null、onLink不触发的问题，可按以下步骤排查修复：

1. 检查AndroidManifest.xml配置 #

确保动态链接的Intent Filter和FirebaseDynamicLinksActivity配置正确，这是Android端接收动态链接的核心：

<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
    </intent-filter>
    <!-- 动态链接接收的Intent Filter -->
    <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"/>
        <!-- 替换为你的Firebase动态链接域名 -->
        <data android:host="your-app.page.link" android:scheme="https"/>
    </intent-filter>
</activity>

<!-- 必须添加FirebaseDynamicLinksActivity用于链接解析 -->
<activity
    android:name="com.google.firebase.dynamiclinks.FirebaseDynamicLinksActivity"
    android:exported="true">
    <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:host="your-app.page.link" android:scheme="https"/>
    </intent-filter>
</activity>

• android:autoVerify="true"需要配合assetlinks.json完成域名验证，否则可能导致链接无法被App直接拦截解析。

2. 确认邮箱登录链接的生成参数 #

发送登录链接时，必须设置handleCodeInApp: true，并确保Android包名等参数正确：

await FirebaseAuth.instance.sendSignInLinkToEmail(
  email: "user@example.com",
  actionCodeSettings: ActionCodeSettings(
    url: "https://your-app.page.link/signin", // 匹配动态链接域名
    handleCodeInApp: true,
    androidPackageName: "com.your.app.package", // 你的App包名
    androidInstallApp: true,
    androidMinimumVersion: "21",
  ),
);

3. 调整动态链接监听的时机 #

getInitialLink()调用过早可能导致获取失败，尝试在App启动后延迟获取：

Future<void> main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);

  runApp(const App());

  // 在App渲染完成后获取初始链接
  WidgetsBinding.instance.addPostFrameCallback((_) async {
    final PendingDynamicLinkData? initialLink = await FirebaseDynamicLinks.instance.getInitialLink();
    if (initialLink != null) {
      debugPrint("Initial link: ${initialLink.link}");
      // 处理登录逻辑
    }
  });

  // 保持onLink监听
  FirebaseDynamicLinks.instance.onLink.listen((data) {
    debugPrint("Received link: ${data.link}");
    if (FirebaseAuth.instance.isSignInWithEmailLink(data.link.toString())) {
      // 处理登录
    }
  }).onError((error) {
    debugPrint("Dynamic link error: $error");
  });
}

也可以将监听逻辑移到启动页（如SplashScreen）中，确保Firebase初始化完全完成后再监听。

4. 排查链接解析日志 #

通过Android Studio的Logcat搜索FirebaseDynamicLinks关键词，查看是否有链接解析失败的错误信息，比如域名验证失败、参数不匹配等。

5. 更新Firebase依赖版本 #

你当前使用的依赖版本相对较旧，尝试更新到最新稳定版，避免版本兼容性问题：

firebase_auth: ^4.10.0
firebase_core: ^2.15.0
firebase_dynamic_links: ^5.3.0

更新后执行flutter pub upgrade，并重新构建App。

6. 测试动态链接有效性 #

使用Firebase控制台的「动态链接」工具生成测试链接，点击后检查是否能被App正确接收，同时验证链接的跳转逻辑是否符合预期。

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