iOS端Firebase动态短链接关联App功能异常排查求助

1. 修复Associated Domains拼写错误 #

你的Runner.entitlements文件里的域名少了字母t，这会直接导致iOS无法验证App Link关联，进而影响动态链接的解析：

<!-- 错误写法 -->
<string>applinks:tes.mydomain.app</string>
<!-- 正确写法 -->
<string>applinks:test.mydomain.app</string>

2. 调整iOS URL Scheme配置 #

Info.plist里用https作为URL Scheme容易和系统默认的URL处理逻辑冲突，建议改为自定义Scheme（比如mydomainapp），同时保留App Links配置：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLName</key>
        <string>es.mydomain.app</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>mydomainapp</string>
        </array>
    </dict>
</array>

同时在动态链接生成代码的iOS参数里补充对应自定义Scheme：

iosParameters: IOSParameters(
    bundleId: 'es.mydomain.app',
    fallbackUrl: Uri.parse('https://mydomain.app/get/'),
    customScheme: 'mydomainapp' // 添加该行
)

3. 完整监听Firebase动态链接 #

仅调用getInitialLink()无法覆盖App后台唤醒的场景，需要同时监听onLink流来处理所有链接触发情况：

@override
void initState() {
  super.initState();
  _initDynamicLinks();
}

void _initDynamicLinks() async {
  // 处理冷启动时的链接
  final PendingDynamicLinkData? initialLink = await FirebaseDynamicLinks.instance.getInitialLink();
  if (initialLink != null) {
    _handleDynamicLink(initialLink);
  }

  // 处理后台唤醒时的链接
  FirebaseDynamicLinks.instance.onLink.listen((dynamicLinkData) {
    _handleDynamicLink(dynamicLinkData);
  }).onError((error) {
    print('动态链接解析错误: $error');
  });
}

void _handleDynamicLink(PendingDynamicLinkData data) {
  final Uri deepLink = data.link;
  // 这里拿到的是你生成时传入的原始深层链接：https://mydomain.app/page1/123456
  if (deepLink.pathSegments.contains('page1')) {
    final String id = deepLink.pathSegments.last;
    Navigator.pushNamed(context, '/page1', arguments: id);
  }
}

你之前iOS端拿到短链接路径（/page1/ABC），说明没有正确解析Firebase动态链接的深层内容，而是直接处理了短链接URL，这大概率是Associated Domains配置错误导致的。

4. 验证Firebase控制台配置 #

• 确认iOS应用的Bundle ID（es.mydomain.app）和Firebase控制台、代码配置完全一致
• 检查动态链接域名（test.mydomain.app）已在Firebase控制台完成验证
• 用Firebase动态链接调试工具验证生成的短链接能否正确解析到原始深层链接

5. 清理环境重新测试 #

• 删除iOS设备上的App，清理Safari缓存
• 重新编译安装App
• 使用生成的短链接测试，确保能正确获取到原始的https://mydomain.app/page1/123456链接

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