如何配置Firebase Deep Link以识别末尾追加的自定义参数

这个问题的核心原因是Firebase Deep Link的默认参数透传逻辑：生成短链时已经包含的参数会被SDK自动透传到你配置的目标深层链接中，短链生成之后额外追加的参数不会被注入到透传的目标链接里，但是这些参数仍然存在于触发跳转的原始Uri中。

方案1：直接修改应用内解析逻辑（最简方案） #

不要依赖Firebase SDK透传的目标链接读取参数，直接从跳转的原始Uri中提取所有查询参数，不受参数位置限制：

• 代码示例如下：

import 'package:firebase_dynamic_links/firebase_dynamic_links.dart';

void handleRegisterDeepLink() async {
  final PendingDynamicLinkData? linkData = await FirebaseDynamicLinks.instance.getInitialLink();
  // 监听后台唤起的动态链接
  FirebaseDynamicLinks.instance.onLink.listen((dynamicLinkData) {
    parseCustomParam(dynamicLinkData.uri);
  });
  
  if (linkData != null) {
    parseCustomParam(linkData.uri);
  }
}

void parseCustomParam(Uri rawUri) {
  // 直接从原始Uri读取所有查询参数，无论参数在什么位置都可正常获取
  final customParam = rawUri.queryParameters['myCustomParam'];
  if (customParam != null) {
    // 处理注册闭环逻辑
  }
}

• 该方案不需要修改现有链接生成、追加逻辑，完全满足你将自定义参数放在链接末尾的业务要求。

方案2：生成短链时配置参数透传规则 #

如果需要兼容现有SDK解析逻辑，可以在生成初始短链时配置透传规则：

• 生成初始短链时，在动态链接的目标链接末尾预留参数占位位，同时开启Firebase控制台的动态链接参数透传配置
• 追加参数时直接在短链末尾拼接即可，Firebase会自动将所有查询参数透传到目标链接中
• 注意所有特殊字符需要做URL编码，避免解析异常

验证注意事项 #

• 测试时需通过应用跳转/扫码的方式触发链接唤起，直接在浏览器地址栏输入链接可能触发缓存导致参数丢失
• 多平台测试时需要确认Android、iOS端的深度链接配置都已开启原始Uri读取权限

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