Universal Link通过Apple验证但无法唤起iOS应用

一、检查Apple Associated Domains文件的核心细节 #

• 确认文件路径为**/.well-known/apple-app-site-association**，无拼写错误（比如不要写成apple-app-site-association.txt或放错目录）
• 服务器返回的文件必须是纯JSON格式，不能包含HTML标签或其他包装；验证MIME类型为application/json，且HTTP状态码为200
• 确认JSON内的appIDs数组包含Team ID + 完整Bundle ID（格式如ABCDE12345.com.yourcompany.yourapp），大小写必须与Apple Developer后台完全匹配
• 检查paths字段的匹配规则：如果测试链接是https://ourwebsite.com/test，paths需包含["/test", "/*"]这类规则，注意路径是大小写敏感的，避免通配符使用错误（比如["*"]不生效，必须用["/*"]）

二、清理设备端Universal Link缓存 #

iOS会缓存关联文件，强制刷新的步骤：

• 卸载应用，重启测试设备
• 重新安装应用，再测试链接唤起

三、验证Xcode与配置文件的一致性 #

• 确认Signing & Capabilities中的Associated Domains格式正确：应为applinks:ourwebsite.com，不要加http://或https://，也不要带末尾斜杠
• 登录Apple Developer后台，检查对应配置文件（Provisioning Profile）的详情，确认Associated Domains权限已启用并包含你的域名
• 若应用基于iOS 13+开发，需同时在SceneDelegate中实现func scene(_ scene: UIScene, continue userActivity: NSUserActivity)方法，仅在AppDelegate中实现continue userActivity无法触发（iOS 13+生命周期由Scene管理）

四、规范测试场景 #

• 避免在Notes、Messages等应用内直接点击测试，优先用Safari打开链接后点击，或复制链接到第三方浏览器测试
• 确保测试链接为HTTPS协议，Universal Link不支持HTTP（本地测试可使用ngrok等工具将本地服务转为HTTPS）
• 检查测试设备的iOS版本：iOS 9-10的路径匹配规则更严格，需确保paths规则符合对应版本要求

五、系统级调试日志排查 #

在Mac终端执行以下命令，查看负责处理Universal Link的系统进程swcd的日志，可定位文件下载、解析或匹配过程中的错误：

log show --predicate 'process == "swcd"' --info

六、补充验证点 #

• 确认Apple Developer后台的对应App ID已启用Associated Domains服务
• 检查Xcode中项目的Bundle ID、Team ID与Apple Developer后台完全一致，无拼写或大小写错误

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