Play Billing Library内购存Firebase遇ProGuard序列化报错求解决方案

这问题我之前帮不少开发者排查过，确实是ProGuard在Release构建时混淆了Play Billing Library里的Purchase相关类，导致Firebase的序列化器找不到可序列化的属性。下面给你两种靠谱的解决思路：

一、直接添加ProGuard规则快速修复 #

ProGuard在Release模式下会把类名、成员变量名混淆成短标识符（比如你看到的com.android.billingclient.api.h就是被混淆后的Purchase类），Firestore的序列化机制需要访问类的可见属性或带注解的成员，混淆后自然找不到可序列化的内容。

你只需要在proguard-rules.pro里添加以下规则，保留Purchase类及其内部类的完整结构：

# 保留Purchase主类及所有成员
-keep class com.android.billingclient.api.Purchase { *; }
# 保留Purchase的内部枚举类（比如PurchaseState）
-keep class com.android.billingclient.api.Purchase$PurchaseState { *; }
# 保留Purchase的Result内部类（如果用到的话）
-keep class com.android.billingclient.api.Purchase$Result { *; }

如果想更宽泛地覆盖所有Purchase相关的嵌套类，也可以用这条规则：

-keep class com.android.billingclient.api.Purchase** { *; }

添加后重新构建Release包，序列化异常应该就会消失。

二、更稳妥的长期方案：封装自定义数据类 #

虽然ProGuard规则能快速解决问题，但直接将第三方库的对象存入Firestore并不是最佳实践——如果后续Play Billing Library更新类结构（比如新增/删除字段、修改成员访问权限），可能会导致序列化/反序列化失败。

更稳妥的方式是自己定义一个和Purchase核心数据对应的自定义类，把Purchase里需要的字段复制到这个类中，再存入Firestore。举个Kotlin的例子：

import com.android.billingclient.api.Purchase

// 自定义Purchase记录类，只保留你需要的字段
data class AppPurchaseRecord(
    val orderId: String,
    val packageName: String,
    val productId: String,
    val purchaseTime: Long,
    val purchaseState: Int,
    val purchaseToken: String,
    val isAutoRenewing: Boolean,
    // 可以根据需求添加其他字段
)

// 扩展方法：将Purchase对象转换为自定义类
fun Purchase.toAppPurchaseRecord(): AppPurchaseRecord {
    // 注意：如果是多SKU购买，这里需要调整sku的获取逻辑
    val targetSku = skus.firstOrNull() ?: ""
    return AppPurchaseRecord(
        orderId = orderId,
        packageName = packageName,
        productId = targetSku,
        purchaseTime = purchaseTime,
        purchaseState = purchaseState,
        purchaseToken = purchaseToken,
        isAutoRenewing = isAutoRenewing
    )
}

之后存入Firestore时，就用转换后的AppPurchaseRecord对象，而不是直接存Purchase：

val purchase: Purchase = // 你的Purchase对象
val purchaseRecord = purchase.toAppPurchaseRecord()
firestore.collection("purchases").add(purchaseRecord)

如果是Java项目，记得给自定义类添加@Keep注解，或者在ProGuard里保留该类：

-keep class com.your.package.name.AppPurchaseRecord { *; }

这种方式的优势是解耦第三方依赖，数据结构完全由你掌控，后续即使Play Billing Library更新，只要你保证转换逻辑正确，就不会影响Firestore的序列化操作，稳定性更强。

总结 #

• 临时快速修复：添加ProGuard规则保留Purchase类结构；
• 长期稳定方案：封装自定义数据类，避免直接依赖第三方库对象。

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