iOS 10 Universal Link配置问题：Safari无法唤起APP

你已经搞定了Slack这类第三方应用里的Universal Link唤起，但卡在Safari场景——这确实是iOS Universal Link的常见坑，尤其是跨域名跳转的情况。我来帮你梳理关键排查点和解决办法：

先澄清一个常见误解 #

首先纠正：Safari里的Universal Link不是仅在跨域名时生效，而是触发逻辑更严格：

• 若用户直接在Safari地址栏输入链接、从书签/历史记录打开，默认会在浏览器打开，不会唤起APP
• 只有当链接是从其他网页跳转（同/跨域名均可）、且符合验证规则时，才会触发唤起逻辑

你尝试的跨域名跳转场景是可行的，咱们一步步来：

步骤1：确保两个域名的apple-app-site-association配置完全合规 #

不管站点A还是站点B，都要保证根目录或.well-known目录下的这个文件符合要求：

• 文件不能带.json后缀
• 内容格式要准确，包含你的Team ID和Bundle ID：

{
  "applinks": {
    "apps": [],
    "details": [
      {
        "appID": "你的TeamID.你的BundleID",
        "paths": [ "/alfa/*", "/target-path/*" ] // 覆盖所有需要唤起的路径
      }
    ]
  }
}

• 服务器返回的Content-Type必须是application/json
• 必须通过HTTPS访问（iOS 9+强制要求，测试可用自签名证书，正式环境需可信证书）

步骤2：优化跨域名跳转的触发方式 #

站点A的页面（比如http://my.first-site.com/alfa）里，别用普通<a>标签直接跳转——Safari可能直接打开新页面而非触发Universal Link。建议用以下方式：

• 方案一：在用户点击事件内用JS触发跳转：

document.querySelector('#jump-btn').addEventListener('click', function(e) {
  e.preventDefault();
  window.location.href = 'http://my.other-site.com/target-path';
});

• 方案二：用<a>标签但添加rel="noopener noreferrer"属性，且必须是用户主动点击触发（不能自动跳转）

步骤3：用调试工具验证Universal Link状态 #

连接iOS设备到Mac，通过Xcode查看日志确认：

1. 打开Xcode的Window > Devices and Simulators
2. 选中你的设备，点击Open Console
3. 搜索swcd（Safari Web Content Daemon），能看到Universal Link的验证日志——比如是否成功下载配置文件、是否匹配APP ID

步骤4：重置用户的Safari选择记忆 #

如果用户之前在Safari里选过"在浏览器中打开"该链接，iOS会记住这个偏好，后续不再唤起APP。可以让用户重置：

• 方式一：设置 > Safari > 通用 > 清除历史记录与网站数据（会清除所有Safari数据）
• 方式二：设置 > 你的APP > Safari > 清除网站数据（更精准，仅清除该APP关联的网站数据）

额外注意事项 #

• iOS 10对配置文件的缓存很严格，修改apple-app-site-association后，可能需要重启设备或重置Safari缓存才会生效
• 确保APP的Capabilities里已经开启Associated Domains，并添加两个域名的关联：applinks:my.first-site.com和applinks:my.other-site.com

按这些步骤排查，应该就能解决Safari跨域名跳转唤起APP的问题了。

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