Play Store Billing：无需开发者API处理订阅续订及取消边缘场景

嘿，这个场景确实是订阅处理里的常见坑——queryPurchases()因为依赖本地缓存，确实没法实时同步Google Play那边的订阅状态变更。不用Google Play Developer API也能搞定，我给你几个实用的思路：

核心问题：为什么queryPurchases()拿不到最新数据？ #

queryPurchases()是同步方法，只会读取本地存储的购买快照，不会主动去Google Play服务器拉取最新状态。当用户取消订阅但还在有效期内时，服务器端的状态已经更新（自动续订关闭），但本地缓存没同步，所以你拿到的数据一直不变。

解决方案1：改用异步查询获取服务器最新数据 #

替换成queryPurchasesAsync()，这个方法会触发网络请求，直接从Google Play服务器拉取当前的订阅状态，能准确拿到「已取消但未到期」的订阅信息。

示例代码（Kotlin）：

// 确保BillingClient已连接成功
billingClient.queryPurchasesAsync(
    QueryPurchasesParams.newBuilder()
        .setProductType(BillingClient.ProductType.SUBS)
        .build()
) { billingResult, purchases ->
    if (billingResult.responseCode == BillingClient.BillingResponseCode.OK && purchases != null) {
        // 在这里处理最新的订阅数据
        processSubscriptionStatus(purchases)
    } else {
        // 处理错误，比如网络问题、无权限等
        handleBillingError(billingResult)
    }
}

解决方案2：监听订阅状态变更回调 #

设置PurchasesUpdatedListener，当用户执行取消订阅、续订等操作时，Google Play会主动回调这个listener，这时候你可以立即触发一次异步查询，确保本地状态和服务器同步。

示例代码：

// 创建状态变更监听器
val purchasesUpdatedListener = PurchasesUpdatedListener { billingResult, purchases ->
    when (billingResult.responseCode) {
        BillingClient.BillingResponseCode.OK -> {
            purchases?.let { processSubscriptionStatus(it) }
        }
        BillingClient.BillingResponseCode.USER_CANCELED -> {
            // 用户取消了操作，立即查询最新订阅状态
            queryLatestSubscriptionStatus()
        }
        else -> {
            handleBillingError(billingResult)
        }
    }
}

// 初始化BillingClient时绑定监听器
val billingClient = BillingClient.newBuilder(context)
    .setListener(purchasesUpdatedListener)
    .enablePendingPurchases()
    .build()

// 封装查询最新状态的方法
private fun queryLatestSubscriptionStatus() {
    billingClient.queryPurchasesAsync(...) // 复用方案1的查询逻辑
}

关键：正确解析订阅的有效状态 #

拿到Purchase列表后，不要只看isAutoRenewing字段，要结合expirationTime判断：

• isAutoRenewing = true：订阅正常，会自动续订
• isAutoRenewing = false但System.currentTimeMillis() < expirationTime：用户已取消订阅，但仍在当前计费周期内，需要允许访问内容
• System.currentTimeMillis() >= expirationTime：订阅完全过期，停止访问权限

示例处理逻辑：

private fun processSubscriptionStatus(purchases: List<Purchase>) {
    val targetSku = "你的订阅SKU"
    val activePurchase = purchases.firstOrNull { it.products.contains(targetSku) }

    val isSubscriptionActive = if (activePurchase != null) {
        // 自动续订开启，或者还没到过期时间，都算有效状态
        activePurchase.isAutoRenewing || System.currentTimeMillis() < activePurchase.expirationTime
    } else {
        false
    }

    // 更新用户权限或UI状态
    updateUserAccess(isSubscriptionActive)
}

额外注意事项 #

• 每次用户进入订阅相关页面、启动App时，都调用一次queryPurchasesAsync()，避免依赖过时的缓存数据
• 处理离线场景：如果用户离线，异步查询会返回缓存数据，这时候可以保留上次的有效状态，或者提示用户检查网络
• 错误重试：如果查询返回网络错误，可以设置合理的重试机制，不要直接提示失败

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