同域触发Deep Links(Universal Links)无法唤起App解决方案咨询

这不是配置错误，是iOS Universal Links、Android App Links的系统级默认行为：

• iOS规则：当用户已经在浏览器中浏览app.example.com域名下的页面时，所有同域名链接点击都会默认在当前浏览器内完成跳转，不会触发App唤起，该设计是为了避免用户浏览网页时被无意义打断。
• Android规则：App Links遵循完全相同的逻辑，当前页面域名与跳转目标域名一致时，系统优先响应网页导航，不会唤起App。

以下方案均经过线上环境验证，按稳定性优先级排序：

方案1：独立中转域名跳转（稳定性最高，推荐优先使用） #

这是目前通用的成熟实现方案，无系统版本兼容问题：

• 准备一个和主站不同的二级域名作为中转域名，例如redirect.example.com，注意不要将这个域名加入App的通用链接/应用链接域名配置列表。
• 将app.example.com/confirmed页面内的「返回App」按钮跳转地址，改为指向中转域名的路径，例如https://redirect.example.com/back-to-app。
• 在中转域名的服务端配置302规则，所有访问/back-to-app路径的请求，直接重定向到目标地址https://app.example.com/。
• 原理：用户点击链接时的初始域名为redirect.example.com，和当前浏览的app.example.com不同域，系统会正常触发通用链接/应用链接的校验逻辑，成功唤起App。
• PC端适配：在中转域名的服务端增加UA判断，如果识别到是PC端浏览器访问，直接重定向到https://app.example.com/的网页端即可，完全不影响PC用户的正常访问。
• Ionic适配：不需要修改App端原有Deep Links的路由配置，原有逻辑完全复用，仅需要调整网页端按钮跳转地址和中转页的重定向规则即可。

方案2：自定义URL Scheme兜底（无需额外域名，适合快速上线） #

如果不想额外配置中转域名，可以用自定义Scheme配合超时降级实现：

1. 在Ionic v6项目中配置自定义URL Scheme，例如myapp://home，可直接通过官方Deep Links插件完成配置，无需额外原生代码改动。
2. 不要直接用a标签的href属性跳同域地址，给「返回App」按钮绑定主动点击事件，参考代码如下：

   const backBtn = document.getElementById('backToAppBtn');
   backBtn.addEventListener('click', (e) => {
     e.preventDefault();
     // 尝试唤起App
     window.location.href = 'myapp://home';
     // 3秒未唤起成功则跳转网页端，兼容未装App、PC端场景
     setTimeout(() => {
       window.location.href = 'https://app.example.com/';
     }, 3000);
   });
   

3. 注意事项：
   • iOS部分版本的Safari会弹出“是否打开App”的确认框，体验略差于中转域名方案
   • Android Chrome 25及以上版本会拦截非用户主动触发的Scheme跳转，所以上述逻辑必须绑定在用户点击事件中，不要做页面加载自动触发
   • PC端无法识别自定义Scheme，超时后会自动跳转网页首页，不会影响正常访问

避坑提醒 #

• 不要尝试在app.example.com/confirmed页面通过自动重定向（meta刷新、JS location跳转）跳同域地址，双端系统都会拦截这类触发，100%无法唤起App，没有绕过空间。
• 中转域名一定不要加入iOS的Associated Domains、Android的App Links域名配置列表，否则会再次触发同域不跳转的问题。
• 如果用Capacitor打包Ionic应用，注意capacitor.config.json中的server.hostname配置不要和网页端域名重合，避免App内WebView被识别为同域场景，影响内部跳转逻辑。

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