看起来你已经把Universal Links的基础配置都搞定了，但iOS的直接跳转逻辑确实藏着不少容易踩的坑，我来帮你梳理几个可能遗漏的关键点：

1. 检查apple-app-site-association的paths匹配规则 #

iOS对paths的匹配是严格区分大小写、路径结构的，哪怕是末尾的斜杠差异都可能导致不触发直接跳转：

• 确保你配置的paths规则完全覆盖了目标页面的URL，比如如果用户访问的是https://www.domain.com/articles/123，你的paths里需要有"/articles/*"或者精确的"/articles/123"
• 避免使用过于宽泛的通配符（比如仅["/*"]），同时注意不要用NOT规则意外排除了目标路径
• 检查JSON格式是否正确，比如applinks结构里的apps必须是空数组，不能省略：

  {
    "applinks": {
      "apps": [],
      "details": [
        {
          "appID": "你的TeamID.你的BundleID",
          "paths": [ "/pages/*", "/products/456" ]
        }
      ]
    }
  }
  

2. 确认ASP.NET服务器的静态文件配置 #

ASP.NET默认可能对隐藏目录（比如.well-known）有访问限制，即使浏览器能打开文件，iOS的验证服务可能拿到异常响应：

• 在web.config中添加对.well-known目录的权限和MIME类型配置：

  <location path=".well-known">
    <system.webServer>
      <staticContent>
        <!-- 确保文件的MIME类型正确，这里用application/json即可，不需要pkcs7-mime -->
        <mimeMap fileExtension="." mimeType="application/json" />
      </staticContent>
      <security>
        <authorization>
          <allow users="*" />
        </authorization>
      </security>
    </system.webServer>
  </location>
  

• 检查URL重写规则，确保没有把.well-known/apple-app-site-association的请求重定向到其他页面（比如默认首页），iOS要求该请求必须直接返回200状态码，无任何重定向

3. 重置iOS的Universal Links缓存 #

iOS会缓存apple-app-site-association文件，哪怕你更新了配置，旧缓存可能依然生效：

• 删除设备上的APP，重启设备后重新安装
• 打开Safari的设置，清除“网站数据”
• 如果用模拟器测试，执行命令xcrun simctl openurl booted https://www.domain.com/你的测试路径强制触发链接验证

4. 检查APP的权限和配置细节 #

• 确认Associated Domains entitlement里的域名格式完全正确（比如applinks:www.domain.com，不要带https前缀或路径）
• 检查apple-app-site-association中的appID是否是TeamID.BundleID的精确组合，TeamID要和开发者账号完全一致，BundleID要和APP的配置完全匹配（大小写、标点都不能错）
• 检查设备的APP权限：进入「设置」-> 你的APP名称 ->「关联域名」，确保开关处于开启状态（如果用户之前手动关闭过，iOS会一直显示横幅而不直接跳转）

5. 理解iOS的Universal Links默认行为 #

iOS 13及以后，Universal Links的直接跳转有一个用户交互逻辑：

• 第一次访问链接时，iOS会显示横幅，只有当用户点击过「打开」按钮后，后续访问相同域名的链接才会自动直接跳转
• 如果用户曾选择「取消」或者手动关闭了APP的关联域名权限，iOS会一直显示横幅，直到用户重新授权

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