You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Flutter iOS构建包Deeplinking失效但安卓端运行正常,该如何排查?

通用链接配置失效常见排查点

前提:已完成AASA文件部署、entitlement关联域名配置、entitlement已纳入Bundle Resources

  • AASA文件配置异常:检查文件是否放置在站点根目录或.well-known路径下,必须支持HTTPS访问且无301/302等重定向,返回Content-Type必须为application/json;JSON内容无语法错误、无多余字符/逗号,teamID与bundleID的组合和应用配置完全一致,路径匹配规则书写符合苹果规范;同时不要对AASA文件设置访问鉴权、IP限制,确保苹果服务器可以正常拉取。
  • entitlement域名格式错误:关联域名必须以applinks:为前缀,不能带协议头、路径、参数、端口号,正确格式示例为applinks:example.com,不要书写为applinks:https://example.com/path这类错误格式。
  • 苹果CDN缓存问题:AASA文件部署或更新后,苹果全球CDN存在最长24小时的缓存时效,更新后的配置不会立即生效。测试阶段可安装苹果开发者模式描述文件,绕过CDN缓存直接拉取站点最新AASA。
  • 应用拉取时机问题:AASA文件仅会在应用首次安装、应用版本更新时向苹果服务器请求拉取,修改AASA后如果没有重装或升级应用,本地设备会沿用旧的配置。
  • 测试场景不符合要求:通用链接不会在浏览器地址栏直接输入、同域WebView内跳转时触发,必须是跨域链接点击、备忘录/信息等外部应用点击链接才会唤起应用。
  • 本地权限/配置被重置:检查设备设置->对应应用->「从其他APP跳转」权限是否被关闭;如果之前触发通用链接弹窗时选择了「在Safari中打开」,后续该域名的所有通用链接都会默认走Safari打开,需要重装应用恢复默认配置。

内容的提问来源于stack exchange,提问作者icp

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.26 08:06:05