Android Studio内购BillingClient问题：商品详情及购买流程异常

背景 #

几年前开发的Android应用不慎删除，近期重新开发时，集成移除广告的内购功能遇到异常，查阅官方文档及资料后仍未解决。测试环境为Pixel 7 API 34模拟器（已登录Google Play账号，支持Google Play Store）。

初始版本问题 #

• app build.gradle已引入BillingClient 6.1.0依赖
• Java类实现PurchasesUpdatedListener接口，完成BillingClient初始化并连接后查询SkuDetails
• 加载Activity无任何提示，点击升级按钮弹出Toast：SkuDetails not available

更新版本问题 #

• 参考教程调整代码后，升级按钮可显示内购商品名称
• 点击按钮无任何响应，无Toast提示，iapTextView也未更新内容

排查与解决方案建议 #

针对初始版本（SkuDetails加载失败） #

1. 校验Sku参数与商品状态
   • 确认查询的skuId与Google Play Console中配置的内购商品ID完全一致（注意大小写、特殊字符）
   • 检查商品状态为激活，未处于草稿或暂停状态
2. 确保BillingClient连接就绪
   • 在查询SkuDetails前，通过billingClient.isReady()确认客户端已成功连接
   • 仅在BillingClientStateListener的onBillingSetupFinished回调返回BillingResponseCode.OK后，再执行Sku查询逻辑
3. 检查清单权限配置
   • 确认AndroidManifest.xml中已添加权限：<uses-permission android:name="com.android.vending.BILLING" />
4. 输出调试日志定位原因
   • 在onSkuDetailsResponse回调中打印完整BillingResult信息（包含responseCode和debugMessage），明确失败具体原因（如网络异常、商品未找到等）

针对更新版本（按钮点击无响应） #

1. 确认点击事件绑定正常
   • 检查升级按钮的setOnClickListener是否正确设置，或XML中android:onClick配置无遗漏
2. 校验购买流程发起逻辑
   • 确认点击事件中调用了launchBillingFlow方法，且传入的BillingFlowParams包含有效的SkuDetails对象
   • 发起购买前需确保BillingClient.isReady()返回true
3. 检查回调处理逻辑
   • 确认onPurchasesUpdated回调已正确实现，覆盖购买成功、失败、用户取消等场景，且iapTextView更新、Toast提示等UI操作已写入对应分支
4. 确保UI操作在主线程执行
   • 修改iapTextView、弹出Toast等操作需在主线程完成，避免因子线程操作UI导致无反应

关键代码检查点 #

• 初始版本中Sku查询参数构建示例：

  SkuDetailsParams params = SkuDetailsParams.newBuilder()
          .setSkusList(Arrays.asList("your_remove_ad_sku_id"))
          .setType(BillingClient.SkuType.INAPP)
          .build();
  

• 更新版本中购买流程发起示例：

  billingClient.launchBillingFlow(yourActivity, BillingFlowParams.newBuilder()
          .setSkuDetails(targetSkuDetails)
          .build());
  

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