Google Play Billing Library V5内购弹窗未在启动Activity中弹出问题

核心排查与修复方向 #

1. 检查Activity主题兼容性 #

现有应用的Activity主题可能干扰Billing弹窗的附着逻辑，重点排查：

• 移除主题中android:windowIsTranslucent="true"或android:windowBackground="@android:color/transparent"这类透明配置，透明主题会导致Billing系统无法将弹窗绑定到当前Activity，转而启动新容器页面。
• 避免使用Theme.AppCompat.Dialog这类对话框主题，Billing流程需要标准的全屏/常规Activity主题。

2. 验证BillingClient初始化与调用逻辑 #

• 初始化BillingClient时必须传入当前Activity实例，而非Application Context，否则无法正确关联目标页面：

  // 正确初始化示例
  val billingClient = BillingClient.newBuilder(currentActivity)
      .setListener(purchasesUpdatedListener)
      .enablePendingPurchases()
      .build()
  

• 调用launchBillingFlow前，确认传入的activity是当前前台活跃实例，避免传入已销毁或即将销毁的Activity对象。

3. 排查Activity启动模式与任务栈配置 #

• 检查Manifest中目标Activity的launchMode，避免使用singleInstance或singleTask（除非业务强制要求），这类模式会打乱Billing流程的任务栈关联逻辑。
• 排查是否有第三方库（如弹窗、权限管理类）篡改了WindowManager规则，暂时禁用这类库测试是否恢复正常。

4. 统一依赖版本与修复混淆问题 #

• 确保现有应用的Billing Library依赖版本和新项目完全一致，版本差异可能引发兼容性问题：

  implementation 'com.android.billingclient:billing:5.2.0' // 保持版本统一
  

• 在proguard-rules.pro中添加Billing相关类的混淆豁免规则，避免核心类被混淆导致逻辑异常：

  -keep class com.android.billingclient.** { *; }
  -keep class com.android.vending.billing.** { *; }
  

5. 验证设备环境 #

• 更新测试设备的Google Play服务到最新版本，旧版本可能存在Billing UI显示的适配问题。
• 在多台不同品牌/系统版本的设备上测试，排除设备特定的系统适配异常。

额外验证步骤 #

• 调用launchBillingFlow前，通过activity.isFinishing和activity.isDestroyed检查Activity状态，确保处于活跃状态。
• 开启BillingClient调试日志，查看是否有错误信息输出：

  billingClient.startConnection(object : BillingClientStateListener {
      override fun onBillingSetupFinished(result: BillingResult) {
          Log.d("BillingDebug", "Setup result: ${result.responseCode} - ${result.debugMessage}")
          // 后续调用launchBillingFlow
      }
      override fun onBillingServiceDisconnected() {
          // 重连逻辑
      }
  })
  

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