Flutter iOS发布版Firebase动态链接数据获取失败求助

核心问题复盘 #

• 功能逻辑：未安装App的用户通过Firebase动态链接安装注册后，需从链接提取数据添加指定好友
• Android端全程正常，基于FirebaseDynamicLinks.instance.getInitialLink()实现
• iOS端异常表现：
  1. 初始用firebase_dynamic_links包的getInitialLink()无法获取链接数据
  2. 换用app_links包的getInitialAppLink()在开发环境正常，但归档发布到App Store后完全失效

配置检查与修复步骤 #

1. 关联域配置修正 #

从你提供的Xcode截图可见，关联域格式错误：

• 正确格式应为 applinks:app.mydomain.com（无需带https://或具体路径）
• 错误点：当前配置了带路径的https://app.mydomain.com/connect，这会导致生产环境无法匹配动态链接规则
• 修正后仅保留applinks:app.mydomain.com即可

2. Info.plist配置优化 #

（1）FirebaseDynamicLinksCustomDomains调整

当前配置带路径的域名，需改为根域名：

<key>FirebaseDynamicLinksCustomDomains</key>
<array>
    <string>https://app.mydomain.com</string>
</array>

无需添加/connect这类子路径，Firebase会自动处理所有子路径的动态链接

（2）CFBundleURLName修正

当前值为占位符Bundle ID，需替换为项目实际的Bundle ID（如com.my.bundle），确保与Xcode项目配置完全一致：

<key>CFBundleURLName</key>
<string>com.my.bundle</string>

（3）LSApplicationQueriesSchemes补充

需添加Firebase动态链接专属scheme，保证App能正常识别链接：

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>https</string>
    <string>http</string>
    <string>firebasedynamiclinks</string>
</array>

3. 代码层面适配生产环境 #

（1）回归firebase_dynamic_links官方包（不建议混用第三方包）

生产环境下官方包兼容性更稳定，建议统一使用firebase_dynamic_links，同时补充后台唤醒链接的监听逻辑：

// 初始化时获取启动链接
final PendingDynamicLinkData? initialLink = await FirebaseDynamicLinks.instance.getInitialLink();
if (initialLink != null) {
  handleDynamicLink(initialLink);
}

// 监听后台唤醒的链接
FirebaseDynamicLinks.instance.onLink.listen((dynamicLinkData) {
  handleDynamicLink(dynamicLinkData);
}).onError((error) {
  // 错误日志上报
});

void handleDynamicLink(PendingDynamicLinkData data) {
  final Uri? deepLink = data.link;
  if (deepLink != null) {
    // 提取查询参数处理添加好友逻辑
    String? targetUserId = deepLink.queryParameters['target_user_id'];
    if (targetUserId != null) {
      // 执行添加好友操作
    }
  }
}

（2）处理App Store安装后的链接延迟

iOS从App Store安装后，动态链接传递可能存在延迟，建议在注册完成后主动再次获取链接：

// 注册流程完成后调用
void checkDynamicLinkAfterSignUp() async {
  final PendingDynamicLinkData? link = await FirebaseDynamicLinks.instance.getInitialLink();
  if (link?.link != null) {
    handleDynamicLink(link!);
  }
}

4. Firebase控制台配置验证 #

• 登录Firebase控制台，进入动态链接模块，确认自定义域名app.mydomain.com已完成验证
• 检查动态链接的短链接配置，确保目标URL参数正确，且iOS端App关联配置状态为生效

5. 生产环境测试技巧 #

• 使用TestFlight进行预发布测试，这是最接近App Store生产环境的验证方式
• 测试时通过短信、邮件或社交媒体分享链接，模拟真实用户的触发场景，不要直接复制链接到Safari

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