Flutter调试模式下AppLink失效问题求助

问题场景 #

开发调试Flutter Android应用时，配置AppLink后，在手机浏览器访问对应域名无法启动应用。已完成以下操作但问题依旧：

• 生成并部署assetlinks.json至服务器.well-known目录，且通过Google Digital Asset Links工具验证成功
• 集成uni_links 0.5.1库
• 为MainActivity配置了对应的<intent-filter>
• 实现了uni_links初始化及链接监听逻辑
• 重新构建并安装了调试版应用

针对性排查与解决步骤 #

1. 确认调试版应用的SHA-256指纹匹配 #

调试版与发布版应用使用的签名指纹不同，若assetlinks.json中填写的是发布版指纹，调试版应用将无法通过验证：

• 获取调试版签名指纹的命令：

  keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
  

• 将获取到的指纹更新到assetlinks.json中，重新上传至服务器，再用Digital Asset Links工具验证。

2. 检查AndroidManifest.xml的Intent Filter配置 #

确保配置包含AppLink必需的参数：

<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="your-domain.com" />
</intent-filter>

• 必须添加android:autoVerify="true"，这是AppLink自动验证的核心开关
• 避免为MainActivity设置singleInstance这类可能拦截Intent的启动模式，建议使用默认的standard或singleTop

3. 强制清除AppLink验证缓存 #

调试模式下系统可能缓存旧的验证结果，执行以下命令清除：

adb shell pm clear-domain-preferences

之后卸载应用，重新安装调试版，再尝试访问域名。

4. 验证uni_links的初始化逻辑 #

确保在应用启动时就完成链接监听，示例代码：

@override
void initState() {
  super.initState();
  _initUniLinks();
}

Future<void> _initUniLinks() async {
  // 处理冷启动时的初始链接
  try {
    final initialLink = await getInitialLink();
    if (initialLink != null) {
      // 这里添加你的链接处理逻辑
      print('冷启动链接: $initialLink');
    }
  } on PlatformException {
    // 捕获异常
  }

  // 监听热启动时的链接
  linkStream.listen((String? link) {
    if (link != null) {
      // 这里添加你的链接处理逻辑
      print('收到链接: $link');
    }
  }, onError: (err) {
    // 处理错误
  });
}

5. 测试时的注意事项 #

• 不要使用浏览器的隐身模式，隐身模式可能会禁用AppLink跳转
• 确保手机网络能正常访问你的服务器（需验证assetlinks.json可被手机直接访问）
• 部分浏览器需手动开启AppLink跳转权限，可在浏览器设置中检查相关选项

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