Android Billing Client 3.0.2 接入后LeakCanary检测到内存泄漏
集成Google Play Billing时已销毁Activity内存泄漏问题分析
泄漏触发原因
对照LeakCanary给出的完整引用链路,这个问题是Billing 3.0.2版本的实现缺陷搭配当前代码逻辑共同触发的,核心泄漏链路拆解如下:
- 主线程MessageQueue中残留了Billing连接阶段投递的未执行异步任务:从堆栈信息可以看到,这条消息的排期在堆转储14773ms之后才会被执行,消息回调是Billing混淆后的内部类
com.android.billingclient.api.zzr,这个对象顺着内部引用链一直持有BillingClientImpl实例。 - BillingClientImpl在3.0.2版本的断开流程存在逻辑缺失:该版本在
endConnection()执行时,并不会清空内部保存的PurchasesUpdatedListener引用。你当前代码里的PurchasesUpdatedListener是MainActivity的匿名内部类,匿名类会隐式强引用外部的MainActivity实例,最终形成「排队的主线程消息 → BillingClientImpl → 匿名Listener → 已标记销毁的MainActivity」的完整引用链。 endConnection()的清理范围不完整:3.0.2版本的endConnection()仅会断开和Play商店服务的跨进程连接,既不会主动把已经投递到主线程队列的Billing相关异步消息移除,也不会清空之前设置的各类监听器引用。只要排队的异步消息没被执行,整条引用链就一直存在,哪怕MainActivity已经走完onDestroy回调被标记为mDestroyed=true,也无法被GC回收。
对应修复方案
- 优先升级依赖版本解决根源问题:将
com.android.billingclient:billing:3.0.2升级到4.0.0及以上的稳定版本,这个版本中Google官方补全了endConnection()的全量清理逻辑,包括移除主线程中排队的Billing相关异步消息、置空内部持有的监听器引用,从实现层面切断泄漏链路。 - 如果受项目兼容限制暂时无法升级,可手动补全引用解绑逻辑:
- 把原本作为Activity成员变量的匿名
PurchasesUpdatedListener,替换为静态内部类+弱引用持有Activity的实现,消除匿名类对Activity的强引用绑定。 - 在
onStop生命周期中,先给billingClient设置空实现的监听器,再调用endConnection(),主动断开BillingClientImpl到Activity的直接引用。 - 避免将BillingClient实例作为Activity的长期成员变量持有,可将BillingClient设计为Application层的全局单例,把监听器的绑定、解绑逻辑和Activity的生命周期对齐,避免单例实例长期持有Activity的引用。
- 把原本作为Activity成员变量的匿名
- 效果验证:复现「启动MainActivity → 等待Billing连接建立 → 立刻退出Activity」的操作路径,等待LeakCanary的泄漏检测周期走完,确认上述引用链不会再被捕获。
内容的提问来源于stack exchange,提问作者beginner
相关产品推荐
相关产品推荐

