Expo开发的应用配置Universal Links后iOS无法唤起问题排查

Expo配置层的常见疏漏 #

• 核对associatedDomains的配置层级：Expo SDK 48及以上版本要求该配置必须放在ios.associatedDomains路径下，直接写在app.json根目录的配置不会被打包进最终iOS安装包，系统无法读取关联域信息。
• 修正关联域名的格式错误：苹果关联域不支持单独配置applinks:*.<DOMAIN_NAME>.com这类前置通配符条目，必须把所有实际需要唤起的子域名、根域名逐行明确列出，仅靠通配符形式的配置系统不会识别。
• 确认appID格式正确：AASA文件里的appID必须是<开发者团队ID>.<应用Bundle ID>的完整格式，不能只填Bundle ID，也不能填错对应团队的ID，否则系统会直接匹配失败。

AASA文件的实际生效问题（即使第三方校验工具通过也容易出现） #

• 验证线上实际可访问性：用终端执行curl -I https://<你的域名>/.well-known/apple-app-site-association，确认接口直接返回200状态，无301/302跳转，无自动添加的HTML包裹、无错误的Content-Type响应。iOS系统拉取AASA时不会跟随跳转，只要首次请求不是直接返回正确内容，系统就会放弃拉取配置。尤其你将AASA文件放在代码仓库src目录的场景，要确认静态站点构建流程没有过滤、重命名.well-known目录下的文件，没有把该路径的请求重定向到网站首页、语言选择页——很多人遇到的第三方校验通过、但系统拉取失败的问题，就是构建流程没把AASA文件正确输出到线上路径导致的。
• 匹配AASA的路径规则：你当前配置的匹配规则仅覆盖/login/*路径，测试时必须使用对应路径的完整链接，其他路径的链接本身就不在唤起规则内，自然无法触发唤起。
• 核对内容格式一致性：如果配置的响应头是application/pkcs7-mime，就不能返回明文JSON格式的内容；如果使用明文JSON格式，就不要设置pkcs7-mime的响应头，格式不匹配会直接导致系统解析失败。

测试与系统层面的常见误区 #

• 用正确方式测试唤起：不要在Safari地址栏直接输入链接测试，iOS的Universal Link不会对地址栏输入的内容触发唤起。正确测试场景为：将链接存入系统备忘录、通过iMessage发送、在第三方App（如微信）内点击链接。
• 确认系统配置拉取时机：App安装完成后，系统会在后台延迟拉取关联域名的AASA配置，刚装完立刻测试可能存在配置未拉取完成的情况，可以删除App重装后等待5分钟左右再测试，也可以直接重启设备触发系统的配置拉取流程。
• 区分内部WebView的触发逻辑：当你的App已经内嵌WebView加载对应域名的页面时，WebView内的链接跳转不会触发Universal Link唤起——系统不会对已经打开的同一个App做重复唤起操作，这类内部链接需要通过WebView的代理逻辑单独处理跳转。

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