Android Instant Apps异常：点击URL显加载页后跳转浏览器，生产环境失效

我之前也碰到过几乎一模一样的问题！当时折腾了好几天才找到根源，给你分享几个最可能的排查方向：

• 检查App Links验证状态：
  Play生产环境中，Instant Apps的正常启动依赖App Links的完整验证。大概率是你的域名关联出了问题：

  • 确认域名下的assetlinks.json文件是否公开可访问（用浏览器访问该文件，确保返回HTTP 200状态），且文件内包含生产签名的SHA-256指纹（本地测试用的是调试签名，生产环境必须替换成发布签名的指纹）。
  • 可以在Google Play Console的「App integrity」或「Instant Apps」板块查看域名验证状态，有没有未通过的警告。

• 核对Instant Apps版本配置：

  • 检查Play Console中Instant Apps的版本状态，是否不小心将某个版本设置为「暂停发布」，或者主应用版本更新后，Instant App版本未同步升级导致版本不兼容。
  • 确认Instant App模块的AndroidManifest.xml中是否配置了android:targetSandboxVersion="2"，这是Instant Apps的强制要求，缺失的话会导致生产环境加载失败。

• 验证URL过滤规则一致性：
  本地测试时Android Studio会自动处理Intent Filter，但生产环境需要确保：

  • AndroidManifest.xml中的<intent-filter>（处理App Links的部分）规则，和Play Console「Instant Apps」配置里添加的关联域名完全匹配，不能有遗漏或错误。
  • 不要随意修改scheme、host或path规则，改动后必须同步更新Play Console的域名配置并重新验证。

• 排查ProGuard/R8混淆问题：
  如果开启了代码混淆，很可能是Instant Apps相关组件被混淆导致加载失败：

  • 在proguard-rules.pro中添加规则保留Instant Apps核心类：

    -keep class com.google.android.instantapps.** { *; }
    

  • 同时保留你自己的启动Activity、处理App Links的Activity的类名和关键方法，避免被混淆重命名：

    -keep class com.yourpackage.YourInstantAppLaunchActivity { *; }
    

• 查看生产环境崩溃日志：
  去Google Play Console的「Vitals」->「Crashes and ANRs」，筛选Instant Apps的版本，查看具体的崩溃堆栈。我当时就是在这里发现了ClassNotFoundException，根源是混淆把处理App Links的Activity给重命名了，导致系统无法找到组件直接退出。

另外还有个小概率情况：测试设备的Google Play Services版本过低，或者设备本身不支持Instant Apps（不过这种情况通常会直接提示无法运行，而非加载后退出），可以让测试设备更新到最新的Google Play Services再试试。

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