应用内购买（In App Purchase）SKU详情列表为空问题排查求助

Debug构建下SKU列表为空的排查路径 #

• 校验应用签名匹配度：Google Play结算服务会严格校验当前安装包的签名与Play控制台「应用完整性」页面登记的签名是否一致，只要存在差异（哪怕是同包名的本地debug签名构建），就会静默拦截SKU查询请求，直接返回空列表，不会抛出明确的权限错误。可通过命令apksigner verify --print-certs [你的debug包路径]输出签名摘要，与控制台登记的签名字段逐行比对。
• 核对测试渠道授权：如果debug包是本地直装、未加入Play测试轨道的白名单（内部测试/封闭测试/公开测试的测试人员、测试群组列表），即便商品已在Play后台激活，结算服务也不会返回SKU详情，直接返回空列表。
• 排查结算连接初始化时序问题：debug构建下若开启严格模式、关闭了非必要日志，很容易出现billingClient.setup()的onBillingSetupFinished()回调未触发时，就提前调用SKU查询接口的逻辑。此时因结算服务连接未建立，查询会直接返回空结果，且无对应错误日志输出。
• 检查debug网络配置干扰：若debug构建开启了明文流量拦截、自定义抓包代理，Google Play结算接口因安全限制会拒绝响应这类请求，最终表现为SKU列表为空，且本地网络层拦截不会向上层返回明确错误。

生产环境部分用户SKU列表为空的排查路径（无本地复现条件） #

• 验证地区类限制触发场景：
  • 核对每个内购SKU的可售地区配置：最容易触发空返回的原因是仅配置了应用级可售地区、未给单个SKU勾选对应上架区域，这类配置下未覆盖区域的用户查询SKU会直接返回空列表，无任何报错。
  • 核查用户Play账号的绑定支付地区：即便应用和SKU都在某区域上架，若用户Google账号绑定的支付地区未开放对应SKU权限，结算服务会直接拦截请求返回空列表，这类场景与测试账号的地区配置差异大，无法在自有测试环境复现。
• 排查用户端环境异常：
  • 统计空返回用户的Play商店版本：若应用使用的结算库版本要求最低Play商店版本（如Billing Library 5.0+要求Play商店版本≥25.0），版本不满足的旧设备会静默返回空SKU列表，无明确版本不兼容提示。
  • 核查空返回用户的应用安装来源：通过第三方渠道、侧载安装的APK因未走Play官方分发链路，结算服务会判定为非合规来源，返回空SKU列表，不会提示「非Play渠道安装」的错误。
  • 排查用户账号状态：若用户Google账号存在交易违规、被限制内购权限，查询SKU时会直接返回空列表，无明确权限拒绝提示。

快速定位问题的兜底调试方案 #

• 全量上报结算链路的回调信息：不要仅在拿到空列表时记录日志，需要把onBillingSetupFinished返回的响应码、SKU查询接口返回的全量状态码一起上报。多数空列表返回场景下，接口本身会返回对应的错误码（如BILLING_UNAVAILABLE、ITEM_UNAVAILABLE、DEVELOPER_ERROR），若上层逻辑仅判断列表是否为空、未透传状态码，会导致完全无法定位异常原因。
• 埋点关联用户端环境信息：同步上报用户设备型号、Play商店版本、账号绑定地区、应用安装来源，拿到这些字段后可快速聚类空返回的集中场景，比如异常是否集中在旧版本Play设备、特定地区的账号群体。
• 用测试轨道复现场景：将反馈空列表问题的用户账号加入内部测试白名单，引导用户通过官方测试链接安装应用，配合全量埋点即可拿到对应的错误码，快速定位根因。

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