Flutter调试模式Deep Linking正常，发布模式无法跳转指定页面

核心排查方向与修复步骤 #

一、配置层面问题（发布模式专属） #

• 检查SHA-256签名指纹：发布模式使用正式签名证书的SHA-256，必须在Firebase控制台「项目设置」→「应用」→「Android应用」中添加该指纹。调试模式的SHA-256仅适用于开发环境，未添加正式指纹会导致动态链接解析失败。
• 验证域名配置：确认google-services.json中的deep_link_url_prefix对应域名已在Firebase控制台完成域名验证，发布模式下域名未验证会直接阻断链接解析。
• 添加ProGuard/R8混淆规则：发布模式开启混淆后，需在android/app/proguard-rules.pro中加入以下规则，避免Firebase动态链接相关类被混淆：

  -keep class com.google.firebase.dynamiclinks.** { *; }
  

二、代码逻辑问题 #

• 修复路由逻辑与初始化时机：

  1. 统一路由方案：避免混用GetX与原生Navigator，确保上下文全局可用，改用GetX路由替代原生跳转。
  2. 修正条件判断：原代码中uid != null || uid!.isNotEmpty逻辑错误，应改为uid != null && uid!.isNotEmpty，否则空字符串的uid会错误跳转到/profile页面。
  3. 添加冷启动链接处理：发布模式下App完全关闭时，onLink监听可能错过回调，需主动获取初始链接。

  优化后的完整代码：

  FirebaseDynamicLinks dynamicLinks = FirebaseDynamicLinks.instance;
  
  Future<void> initDynamicLinks() async {
    // 处理冷启动时的初始链接
    final PendingDynamicLinkData? initialLink = await dynamicLinks.getInitialLink();
    if (initialLink != null) {
      _handleDynamicLink(initialLink);
    }
  
    // 监听App运行时的动态链接
    dynamicLinks.onLink.listen((dynamicLinkData) {
      _handleDynamicLink(dynamicLinkData);
    }).onError((error) {
      print('onLink error: ${error.message}');
    });
  }
  
  // 抽离链接处理逻辑，复用代码
  void _handleDynamicLink(PendingDynamicLinkData dynamicLinkData) {
    String link = dynamicLinkData.link.toString();
    print("Received dynamic link: $link");
    
    if (uid != null && uid!.isNotEmpty) {
      Get.toNamed("/profile");
    } else {
      Get.offAllNamed("/home");
    }
  }
  

• 确保初始化时机：initDynamicLinks()需在App启动阶段尽早调用，例如在main()函数中runApp()之前，或根Widget的initState()中，避免因初始化过晚错过链接回调。

三、路由匹配验证 #

确认动态链接中的路径与GetX路由配置完全一致，例如链接指向/profile时，GetX路由必须已注册该路径：

GetMaterialApp(
  initialRoute: '/home',
  getPages: [
    GetPage(name: '/home', page: () => HomePage()),
    GetPage(name: '/profile', page: () => ProfilePage()),
  ],
)

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