Flutter应用中Firebase深度链接问题：打开分享链接出现黑屏

1. 检查Firebase初始化时机 #

确保在启动应用前完成Firebase初始化，避免UI渲染前出现未处理的异步操作导致黑屏：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp(options: DefaultFirebaseOptions.currentPlatform);
  runApp(const MyApp());
}

不要在页面组件的initState中延迟初始化Firebase，会导致链接解析时上下文未就绪。

2. 核对AndroidManifest配置细节 #

• 确认动态链接的Intent Filter配置与Firebase控制台域名完全匹配：

<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-dynamic-link-domain.page.link"
    android:scheme="https"/>
</intent-filter>

• 检查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:scheme="your-custom-app-scheme"/>
  </intent-filter>
</activity>

3. 修正动态链接解析逻辑 #

• 避免解析链接时直接替换页面栈，使用全局导航Key确保上下文可用：

final GlobalKey<NavigatorState> navigatorKey = GlobalKey<NavigatorState>();

void main() async {
  // 初始化代码...
  runApp(MyApp(navigatorKey: navigatorKey));
}

// 监听动态链接
FirebaseDynamicLinks.instance.onLink.listen((pendingDynamicLinkData) {
  final Uri? deepLink = pendingDynamicLinkData.link;
  if (deepLink != null) {
    navigatorKey.currentState?.pushNamed(deepLink.path);
  }
}).onError((error) {
  print('动态链接解析失败: $error');
});

• 禁止在链接解析逻辑中执行同步耗时操作，比如同步网络请求，需封装为异步任务避免阻塞UI线程。

4. 处理应用启动模式冲突 #

如果应用使用singleInstance或singleTask启动模式，需在MainActivity中重写onNewIntent传递链接：

override fun onNewIntent(intent: Intent?) {
    super.onNewIntent(intent)
    FirebaseDynamicLinks.getInstance()
        .handleDynamicLink(intent)
        .addOnSuccessListener { pendingDynamicLinkData ->
            pendingDynamicLinkData?.link?.let { deepLink ->
                // 通过MethodChannel将链接传递到Flutter端处理
            }
        }
}

5. 验证测试环境 #

• 使用已验证的Firebase动态链接测试，避免使用未发布的测试域名。
• 优先用真机测试，或通过adb命令模拟链接跳转：

adb shell am start -W -a android.intent.action.VIEW -d "https://your-dynamic-link.page.link/test" com.your.package.name

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