Flutter Firebase Dynamic Links返回null或不返回完整URL如何解决

问题描述 #

• 实现场景：Flutter应用接入Firebase Dynamic Links实现深度链接能力
• 预期效果：点击后端生成的目标链接https://share.app.io/my-custom-url?token=eZhOa9jIXhTuisoaJ1v时，链接监听器可返回携带所有路径、查询参数的完整链接
• 异常表现：插件仅返回host值share.app.io，部分场景返回值为null
• 原有实现代码存在逻辑缺失，代码如下：

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> with WidgetsBindingObserver {
  FirebaseDynamicLinks dynamicLinks = FirebaseDynamicLinks.instance;
 
  @override
  void initState() {
    super.initState();
    initDynamicLinks();
  }
  Future<void> initDynamicLinks() async {
    final PendingDynamicLinkData? data =
    await FirebaseDynamicLinks.instance.getInitialLink();
    final Uri? deepLink = data?.link;
    print("dynamic link data " + deepLink.toString());
    dynamicLinks.onLink.listen((dynamicLinkData) {
      Navigator.push(
        navigatorKey.currentState!.context,
        MaterialPageRoute(
            builder: (context) =>
                ProfilePage()),
      );
    }).onError((error) {
      print('onLink error');
      print(error.message);
    });
  }
}

修复步骤 #

1. 补全客户端链接解析逻辑 #

现有代码的核心错误是onLink监听回调中，完全没有从回调对象里提取链接内容，直接执行了跳转逻辑，自然拿不到完整参数。将初始化逻辑修改为统一处理模式即可：

Future<void> initDynamicLinks() async {
  // 处理App冷启动场景下的链接接收
  final PendingDynamicLinkData? initialLinkData = await FirebaseDynamicLinks.instance.getInitialLink();
  handleDynamicLink(initialLinkData);

  // 处理App处于前台/后台运行状态下的链接接收
  FirebaseDynamicLinks.instance.onLink.listen((event) {
    handleDynamicLink(event);
  }).onError((error) {
    print('动态链接监听异常: ${error.message}');
  });
}

// 统一封装链接解析、跳转逻辑
void handleDynamicLink(PendingDynamicLinkData? linkData) {
  if (linkData == null) return;
  final Uri? fullDeepLink = linkData.link;
  if (fullDeepLink == null) return;
  
  // 此处即可获取完整链接，包含所有路径、查询参数
  print("解析到完整动态链接: $fullDeepLink");
  // 参数读取示例：final token = fullDeepLink.queryParameters['token'];

  Navigator.push(
    navigatorKey.currentState!.context,
    MaterialPageRoute(builder: (context) => ProfilePage(
      token: fullDeepLink.queryParameters['token']
    )),
  );
}

2. 校验端侧与Firebase控制台配置 #

配置缺失会导致SDK无法正确解析链接，甚至返回null，逐项核对以下配置：

• Firebase控制台Dynamic Links板块，确认已添加域名前缀share.app.io，且域名所有权验证流程已走完
• Android端：AndroidManifest.xml中已添加对应host的intent-filter，开启autoVerify属性；域名根目录的.well-known路径下已正确部署assetlinks.json验证文件
• iOS端：工程配置的Associated Domains中已添加applinks:share.app.io；域名根目录已正确部署apple-app-site-association验证文件；Firebase控制台已填写正确的Team ID、App Store ID

3. 校验后端动态链接生成逻辑 #

注意不能直接将自定义路径的链接https://share.app.io/my-custom-url?token=xxx作为Firebase动态链接直接分发，生成时必须符合Firebase动态链接的构造规则：

• 可分发的动态链接必须将目标跳转链接做URL编码后，作为link参数传入动态链接构造请求，同时附带Android包名、iOS应用ID等必填参数
• 如果后端直接返回自定义路径短链，没有走Firebase动态链接生成接口，SDK无法识别内嵌的路径和参数，就只会返回host值，甚至识别失败返回null

快速排查技巧：将待测试的动态链接直接在系统浏览器打开，如果无法跳转到Firebase的中间跳转页，直接报404或打开普通网页，说明动态链接本身生成逻辑错误，和客户端代码无关。

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