Firebase动态链接已安装APP仍跳转App Store问题求助

以下是常见的问题原因及对应解决办法：

1. 关联域名（Associated Domains）配置错误 #

• 检查Xcode项目的Signing & Capabilities面板，确认Associated Domains已添加正确的动态链接域名，格式为applinks:xxx.page.link（或你的自定义域名）
• 登录苹果开发者后台，对应App ID的配置中必须开启Associated Domains权限，且Xcode已同步最新的配置文件
• 验证AASA文件有效性：直接访问你的动态链接域名下的apple-app-site-association文件（如https://xxx.page.link/apple-app-site-association），确认返回的JSON中包含你的App Bundle ID

2. 动态链接的App Store ID或域名配置错误 #

• 登录Firebase控制台，检查动态链接的iOS配置项，确保填写的App Store ID与你的App完全匹配（上架或TestFlight版本的ID一致）
• 若使用自定义域名，确认域名的DNS解析（CNAME指向Firebase指定服务器）已生效，且Firebase控制台中已完成自定义域名的验证

3. Universal Links触发方式不正确 #

• 不要直接在Safari地址栏输入链接测试，需从短信、备忘录、第三方App等外部场景点击链接，Safari直接输入会优先打开网页
• 检查设备设置：设置 > [你的App] > Safari > 允许网站访问需设置为允许
• 重置Universal Links缓存：执行设置 > Safari > 清除历史记录与网站数据，或卸载重装App后重新测试

4. Firebase SDK集成或链接处理逻辑错误 #

• 确保FirebaseDynamicLinks SDK为最新版本，避免版本兼容问题
• 检查链接处理代码：
  • UIKit项目：在AppDelegate的application(_:continue:restorationHandler:)方法中，正确调用DynamicLinks.dynamicLinks().handleUniversalLink(_:completion:)
  • SwiftUI项目：在onOpenURL或SceneDelegate的scene(_:openURLContexts:)中实现链接处理逻辑
• 查看Xcode控制台日志，搜索FirebaseDynamicLinks关键词，排查是否有链接解析失败、权限不足等错误提示

5. 测试环境特殊问题 #

• TestFlight测试时，若TestFlight版本的Bundle ID与正式版不同，需在Firebase动态链接配置中添加该测试Bundle ID
• 模拟器对Universal Links支持有限，建议使用真机测试
• 卸载设备上的旧版本App，重新安装最新测试包，避免旧逻辑干扰

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