如何正确测试Universal links？AASA配置相关问题咨询

问题1：AASA根目录存放有效性与SWCD日志验证 #

• AASA存放于站点根目录属于官方认可的合法路径，可正常生效。iOS 14及以上版本的SWCD会优先请求/.well-known/apple-app-site-association路径，仅该路径请求失败后才会 fallback 到根目录路径。你日志中仅出现.well-known路径的404报错，未出现根目录的请求日志，说明根目录路径请求也触发了异常未被正常捕获。
• SWCD加载状态验证方法：开启设备开发者模式后连接Xcode，在控制台中筛选swcd和apple-app-site-association关键词，加载成功会出现类似Service configuration for domain [你的域名] is ready的日志，加载失败会明确标注失败路径与错误码。
• WordPress站点根目录存放不生效的常见原因是WordPress默认伪静态规则会拦截无后缀名的文件请求，你需要在服务端配置或.htaccess文件中添加规则，放行/apple-app-site-association请求，避免被WordPress路由逻辑拦截。

问题2：问题归属定位方法 #

可通过两步操作100%定位问题归属：

1. 后端侧校验：用Safari分别访问根目录和.well-known目录下的AASA路径，可正常访问、无跳转、无SSL证书错误、JSON格式完全合规即可排除后端问题，反之则为站点侧问题。
2. iOS端校验：将你已验证可用的其他服务的AASA域名配置到当前项目的entitlements中，测试对应Universal Link能否正常调起，可正常调起则说明iOS端配置完全正常，问题归属站点侧，反之则为iOS端配置问题。
   你提到的苹果官方应用搜索校验工具参考价值极低，该工具仅适配旧版Universal Links规则，不会校验iOS14+新增的AASA字段，结果存在歧义属于正常情况，无需采信。

问题3：content-type响应头缺失影响 #

缺失content-type响应头大概率是故障诱因。SWCD对AASA响应头有严格校验要求，虽未强制要求固定取值，但该字段必须存在，推荐设置为application/json，同时需确保响应头不存在content-disposition: attachment字段，否则会被SWCD直接判定为无效文件。

问题4：补充排查思路 #

• 确认站点全链路支持HTTPS，SSL证书为苹果信任的根CA机构签发，无自签名证书、无HTTPS强制跳转中间层
• 检查AASA文件无任何后缀名，文件大小不超过128KB，JSON格式无多余逗号、无注释内容
• iOS16及以上版本可直接在「设置-开发者-Universal Links-Diagnostics」中输入域名，系统会自动输出诊断结果
• 确认entitlements中配置的域名前缀为applinks:，无拼写错误，未添加多余路径后缀
• 测试时避免使用Safari无痕模式、第三方应用内置浏览器，此类场景会屏蔽Universal Links触发

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