Android App Links生产环境可用，模拟器及测试设备无法触发求助

配置与问题描述 #

我已配置如下App Links：

<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:host="sharer.myapp.com" android:scheme="https" />
</intent-filter>

该配置在生产环境可正常触发App跳转，但存在问题：无法打开目标页面。调试阶段，在模拟器及实体测试设备中打开对应链接均失败——尝试过修改应用启动配置为目标URL、从WhatsApp打开链接、切换至release构建变体等操作，链接始终跳转至网页而非打开App。我使用的是Ionic和Capacitor v5，需要协助排查问题。

针对性排查步骤 #

• 验证Digital Asset Links配置
  开启android:autoVerify="true"后，服务器必须部署/.well-known/assetlinks.json文件，且内容需匹配应用包名和对应环境的签名证书指纹（debug、release指纹都要对应）。可通过keytool -list -v -keystore 你的签名文件.jks获取指纹，确保文件能被公开访问，无权限或HTTPS问题。
• 检查Capacitor插件配置
  确保已安装@capacitor/app-links插件，且在capacitor.config.ts中正确配置域名：

  import { CapacitorConfig } from '@capacitor/cli';
  
  const config: CapacitorConfig = {
    appId: '你的应用包名',
    appName: '你的应用名称',
    webDir: 'www',
    android: {
      appLinks: {
        domains: ['sharer.myapp.com']
      }
    }
  };
  
  export default config;
  

  配置完成后执行npx cap sync android同步到Android项目。
• 测试环境签名匹配
  Debug构建使用默认签名证书，若assetlinks.json仅配置了release指纹，debug包无法通过验证，导致跳转失效。可临时添加debug指纹到文件中，或关闭android:autoVerify="true"做测试（生产环境务必开启）。
• 确认Intent-Filter位置
  确保上述intent-filter配置在Capacitor的MainActivity标签内，而非其他Activity。错误的位置会导致系统无法识别该Activity为链接处理入口。
• 用adb命令直接测试Intent
  通过adb命令发送测试Intent，验证App是否能被唤起：

  adb shell am start -a android.intent.action.VIEW -d "https://sharer.myapp.com/test-path"
  

  若命令能唤起App，说明是外部应用（如WhatsApp）的链接解析问题；若不行，说明Intent配置或验证环节存在问题。
• 排查Ionic路由逻辑
  生产环境能跳转但打不开目标页面，大概率是路由配置问题。可在app.component.ts中监听App Links事件，确认是否接收到跳转URL，再手动处理路由：

  import { AppLinks } from '@capacitor/app-links';
  
  // 在initializeApp方法内添加监听
  AppLinks.addListener('appLinkOpen', (data) => {
    console.log('接收到App Link:', data.url);
    // 这里添加路由跳转逻辑，比如使用Router.navigate处理
  });
  

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