Flutter(iOS)：TestFlight/Release模式首次启动时Firebase动态链接无法处理

1. 检查iOS原生端的链接回调与初始化顺序 #

• 确保FirebaseApp.configure()是application(_:didFinishLaunchingWithOptions:)（或SceneDelegate的scene(_:willConnectTo:options:)）中最早执行的代码之一，避免Release模式下的初始化阻塞导致链接丢失。
• 正确实现iOS 13+的SceneDelegate链接转发逻辑，确保动态链接能被Firebase捕获：

  func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
      guard let url = URLContexts.first?.url else { return }
      DynamicLinks.dynamicLinks().handleUniversalLink(url) { _, _ in
          // 无需额外处理，确保Firebase完成链接解析即可
      }
  }
  

• 若Flutter引擎初始化慢于原生链接回调，可临时将链接存入UserDefaults，供Flutter启动后读取兜底。

2. 调整Flutter端的链接检查时机 #

• 不要在main()中立即调用getInitialLink()，等待Flutter框架完全初始化后再执行，比如在页面的initState中结合addPostFrameCallback：

  @override
  void initState() {
      super.initState();
      WidgetsBinding.instance.addPostFrameCallback((_) => _fetchInitialLink());
  }
  
  Future<void> _fetchInitialLink() async {
      final initialLink = await FirebaseDynamicLinks.instance.getInitialLink();
      if (initialLink != null) {
          // 处理动态链接逻辑
      }
  }
  

• 同时监听onLink流，首次启动时getInitialLink()未返回的情况下，onLink可能会收到链接事件：

  FirebaseDynamicLinks.instance.onLink.listen((data) {
      // 统一处理链接逻辑
  }).onError((err) {
      // 错误捕获
  });
  

3. 验证Release/TestFlight的签名与配置 #

• 确认Xcode中Release目标的Associated Domains已正确添加动态链接域名，格式为applinks:xxx.page.link，且配置未被遗漏。
• 检查Release环境的GoogleService-Info.plist，确保DYNAMIC_LINK_DOMAIN和REVERSED_CLIENT_ID与当前环境匹配，避免和Debug版本的plist混淆。
• 确认apple-app-site-association文件已部署到动态链接域名的根目录或.well-known目录，且苹果服务器能正常抓取（TestFlight包会验证该文件的有效性）。

4. 本地存储兜底方案 #

如果以上方法仍未解决问题，可通过原生+Flutter的本地存储做兜底：

• 原生端存储链接：

  func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
      guard let url = URLContexts.first?.url,
            let dynamicLink = DynamicLinks.dynamicLinks().dynamicLink(fromUniversalLink: url)?.url?.absoluteString else { return }
      UserDefaults.standard.set(dynamicLink, forKey: "temp_initial_link")
      UserDefaults.standard.synchronize()
  }
  

• Flutter端读取并处理：

  import 'package:shared_preferences/shared_preferences.dart';
  
  Future<void> _checkInitialLink() async {
      final prefs = await SharedPreferences.getInstance();
      final storedLink = prefs.getString('temp_initial_link');
      if (storedLink != null) {
          // 处理链接
          prefs.remove('temp_initial_link');
          return;
      }
      // 再尝试读取Firebase的初始链接
      final initialLink = await FirebaseDynamicLinks.instance.getInitialLink();
      if (initialLink != null) {
          // 处理链接
      }
  }
  

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