Capacitor开发：Android与iOS端Deep Linking功能失效求助

• 检查Intent Filter的完整配置
  确保Intent Filter包含DEFAULT和BROWSABLE类别，同时设置高于浏览器的优先级，并且开启自动验证：

  <intent-filter android:autoVerify="true">
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="https" android:host="你的域名" />
  </intent-filter>
  

  android:autoVerify="true"必须和Asset Links配置完全匹配，否则系统会跳过域名验证

• 核对签名证书SHA-256的一致性
  用命令导出签名文件的SHA-256：

  keytool -list -v -keystore 你的签名文件.jks
  

  仔细对比Asset Links文件里的指纹，确保大小写、冒号分隔完全一致，没有空格或多余字符。即使Asset Links工具显示成功，手动核对能避免工具缓存或格式问题。

• 重置浏览器和App的链接关联设置

  • 清空浏览器的网站数据（缓存、Cookie等），避免旧的跳转规则被缓存
  • 进入系统设置→你的App→“打开链接”选项，确认已开启允许该App打开链接，若之前有设置默认打开方式，先清除默认值

• 用自定义Scheme排查问题
  添加一个非HTTPS的自定义Scheme Intent Filter，快速验证Deep Link基础功能是否正常：

  <intent-filter>
      <action android:name="android.intent.action.VIEW" />
      <category android:name="android.intent.category.DEFAULT" />
      <category android:name="android.intent.category.BROWSABLE" />
      <data android:scheme="yourapp" />
  </intent-filter>
  

  测试yourapp://test能唤起App的话，说明问题出在HTTPS的Asset Links或域名访问环节，此时检查服务器上的.well-known/assetlinks.json是否能被公开访问（返回200状态码，无跨域限制）。

• 确认Capacitor监听逻辑正确
  在App启动时初始化Deep Link监听，确保代码执行时机正确：

  import { App } from '@capacitor/app';
  
  // 在App初始化完成后调用
  const initDeepLinkListener = async () => {
    await App.addListener('appUrlOpen', (data) => {
      console.log('Deep Link received:', data.url);
      // 处理跳转逻辑
    });
  };
  initDeepLinkListener();
  

  同时确认@capacitor/app插件已安装并通过npx cap sync同步到Android项目。

• 多环境测试排除兼容性问题

  • 换Chrome、Firefox等主流浏览器测试，部分国产浏览器对App Link支持有限
  • 用不同Android版本的设备测试，Android 12+对App Link的验证逻辑更严格，确保设备系统时间准确（证书验证依赖时间）

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