iOS已安装应用触发特定Universal Links跳转App Store且更新无反应求助

问题背景 #

使用第三方SDK（如Firebase）处理iOS Universal Links，apple-app-site-association文件内容如下：

{
  "applinks": {
     "apps": [],
     "details": [
        {
          "appID": "teamid.bundleid",
          "paths": [
              "NOT /auth", 
              "/*"
           ]
       },
     ]
   }
}

多数场景运行正常，但访问域名myappsite.com/deeplink/live-chat时会直接跳转至App Store（应用已安装），进入App Store后显示「更新」按钮但点击无反应。

排查方向 #

• 路径匹配规则验证

  • 检查规则优先级：iOS按数组顺序从上到下匹配路径规则，先匹配到的生效。可暂时注释NOT /auth规则，测试目标链接是否能正常跳转，排除规则冲突。
  • 验证路径写法：确认NOT /auth是否符合预期，若要排除/auth下所有子路径，应写成NOT /auth/*；使用苹果官方验证工具检查目标链接是否匹配到对应的appID。

• apple-app-site-association文件部署与缓存

  • 确认部署路径：文件需放在myappsite.com/.well-known/下，且HTTPS访问无重定向、返回状态码200。
  • 检查Content-Type：服务器需返回application/json类型，避免因text/plain导致苹果无法解析。
  • 重置设备缓存：iOS会缓存该文件，可尝试卸载重装应用、清除Safari网站数据或切换飞行模式刷新缓存。

• 应用配置与签名校验

  • 核对Associated Domains配置：Xcode中需添加applinks:myappsite.com，确保无拼写错误或多余空格。
  • 匹配Team ID与Bundle ID：确认apple-app-site-association中的teamid.bundleid和应用的Team ID、Bundle ID完全一致（含大小写）。
  • 检查签名权限：确认应用签名包含Associated Domains entitlement，可查看Xcode签名报告或ipa包内的embedded.mobileprovision文件验证。

• Firebase动态链接配置检查

  • 确认Firebase控制台已正确关联该域名与对应应用，无配置遗漏。
  • 排查动态链接规则：检查是否存在将该路径重定向至App Store的规则，避免与apple-app-site-association的规则冲突。

• App Store与应用版本问题

  • 核对应用版本状态：若本地安装的是测试版（Ad Hoc/Debug），而App Store为正式版，可能导致系统误判需要更新，可尝试安装正式版测试。
  • 检查Bundle ID唯一性：确认App Store Connect中的Bundle ID与Xcode配置一致，无多个应用共用同一Bundle ID的情况。
  • 多设备测试：用其他iOS设备访问目标链接，排除单个设备的本地异常。

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