App Search API验证工具无法识别Universal Links,报错无法获取应用站点关联文件
Universal Links 无法拉取apple-app-site-association文件排查步骤
- 首先校验文件访问规则:
- 必须通过HTTPS直接访问,不允许任何301/302重定向(包括HTTP跳HTTPS、带www跳转不带www等所有跳转行为都会被苹果服务器拒绝)
- 响应头的
Content-Type必须设置为application/json,不能附带charset=utf-8等后缀,也不能返回text/plain等其他类型 - 服务器不能对访问设置鉴权、验证码、IP拦截规则,需要放行苹果官方爬虫的访问请求
- 校验文件路径与格式:
- 优先将文件存放在站点根目录的
.well-known文件夹下,访问路径为https://你的域名/.well-known/apple-app-site-association,文件不能加.json后缀,文件名必须完全匹配 - 文件编码必须为无BOM头的UTF-8格式,内容不能包含注释、多余的换行或特殊字符
- 优先将文件存放在站点根目录的
- 你提供的
apple-app-site-association文件内容本身没有语法错误,可额外核对appID字段:前面的前缀为苹果开发者账号的团队ID,后缀为应用的Bundle ID,需要和开发者后台配置完全一致 - 本地验证可直接使用curl命令确认返回结果:
curl -v https://你的域名/.well-known/apple-app-site-association,确认返回状态码为200、内容完整符合要求即可
内容的提问来源于stack exchange,提问作者netsplatter
相关产品推荐
相关产品推荐

