如何修复某特定网站上的Deep Link（深度链接）失效问题

问题背景 #

移动端应用深度链接https://www.domain.example/de-app/:id可在多数网站正常唤起应用，但在该链接的基础域名WordPress站点上失效。已知情况：

• 链接由WordPress插件转发，已通过过滤器确保动态参数配置正确
• 为统计点击次数，阻止了a标签的默认href行为，自定义跳转逻辑如下：

anchor.onclick = (e) => {
   e.preventDefault();
   
   try {
     // 异步统计逻辑
     
     self.location.href = e.target.href
   } catch (error) {
      self.location.href = e.target.href
   }
}

可能诱因分析 #

• 同域跳转的浏览器行为差异：浏览器对同域的location.href跳转可能判定为普通页面导航，而非外部应用唤起请求，跳过了深度链接的唤起检测流程。默认a标签点击会触发浏览器的唤起优先级判定，但手动修改location.href可能被优化为内部跳转。
• WordPress插件转发冲突：插件的URL过滤逻辑在处理同域链接时，可能额外添加了重定向、参数修改或内部路由规则，导致最终跳转的URL偏离预期的深度链接结构（比如丢失:id参数、被强制转为内部页面）。
• 异步逻辑的时机问题：如果// some async logic执行耗时过长，会错过浏览器允许唤起应用的时间窗口；若异步逻辑中存在未被try/catch捕获的异常（比如异步错误无法被同步try块捕获），可能导致后续跳转逻辑未执行。
• 浏览器同域安全限制：部分移动端浏览器针对同域深度链接设置了更严格的拦截规则，防止恶意站点滥用同域跳转劫持用户，导致应用唤起被屏蔽。

额外检查点 #

• 打开该WordPress站点的浏览器控制台，检查是否存在JS报错（比如异步统计逻辑的错误、插件脚本冲突）
• 用抓包工具验证点击链接时实际请求的URL，确认与https://www.domain.example/de-app/:id完全一致，无服务器重定向或参数篡改
• 直接在浏览器地址栏输入深度链接，测试是否能唤起应用，排除站点本身的配置干扰
• 检查WordPress固定链接设置，确认深度链接路径未与内部页面路由冲突（避免服务器返回404或内部跳转）
• 临时移除e.preventDefault()，用默认a标签点击测试，验证是否为阻止默认行为导致的唤起失败

优化建议 #

• 调整异步统计逻辑的执行时机，确保在唤起前完成，或添加短延迟给浏览器留出唤起窗口：

anchor.onclick = (e) => {
  e.preventDefault();
  
  const doStats = async () => {
    // 异步统计逻辑
  };
  
  doStats().then(() => {
    setTimeout(() => {
      window.location.href = e.target.href;
    }, 100);
  }).catch(() => {
    window.location.href = e.target.href;
  });
}

• 给深度链接添加特殊标识参数（如?deeplink=1），在服务器端配置中识别该参数后触发唤起逻辑，避免被同域路由规则拦截
• 检查应用端的深度链接配置，确认未过滤同域来源的唤起请求

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