App Clips域状态及高级App Clip体验配置报错问题求助
问题排查方案
1. 修复"Insecure redirects forbidden"错误
- 确认你的AASA文件必须部署在 HTTPS协议 的服务器根路径
.well-known目录下,完整访问路径为https://[你的域名]/.well-known/apple-app-site-association,服务器必须使用HTTPS默认的443端口,访问该路径时不允许出现任何301/302跳转(包括跳转到带www的域名、跳转到http地址、跳转到其他子路径等行为都禁止) - 确认服务器SSL证书为全球信任的CA机构颁发,禁止使用自签名证书、过期证书,TLS版本要求 ≥1.2,禁用弱加密套件
- 确认AASA文件无
.json后缀,服务器返回的响应头Content-Type设置为application/json,访问不需要登录鉴权、无额外参数要求 - 确认AASA文件JSON格式完全合法,无多余的空白字符、语法错误
2. 修复关联域不匹配错误
- 检查Xcode项目中主App和App Clip目标的
Associated Domains配置:- 主App添加条目:
applinks:[你的域名] - App Clip添加条目:
appclips:[你的域名]
注意:关联域配置不需要加https前缀、路径、端口,直接写域名即可,子域名需要单独配置
- 主App添加条目:
- 核对AASA文件内的标识是否完全匹配:
- 前缀
123456789必须和你苹果开发者账号的Team ID完全一致 - App Clip的Bundle ID必须和AASA中
appclips.apps字段内的com.appname.Clip完全匹配 - 你在App Store后台填写的App Clip体验URL,必须属于你配置的关联域名下,例如关联域配置为
example.com,则URL必须为https://example.com/[任意路径]格式,子域名需要单独添加关联域配置
- 前缀
3. 缓存问题处理
苹果CDN对AASA文件的缓存时间最长可达24小时,修改配置后可以等待缓存过期后再重试,调试阶段可以在Xcode关联域配置后加?mode=developer后缀跳过CDN缓存,使用测试设备调试。
内容的提问来源于stack exchange,提问作者user16016486
相关产品推荐
相关产品推荐

