LeakCanary 检测内存泄漏的核心原理

LeakCanary 检测内存泄漏的核心原理

LeakCanary 是 Android 平台常用的内存泄漏检测工具，但在实际开发中，生命周期较长的对象、系统组件缓存、第三方库内部逻辑等场景容易引发误报。要避免误报，核心思路是 明确区分「真正的内存泄漏」和「合法的长生命周期引用」，可以从以下几个层面入手：

一、 理解 LeakCanary 的误报根源

LeakCanary 的原理是监控 Activity/Fragment/View 等对象的生命周期，当这些对象本该被 GC 回收时却仍被强引用持有，就会判定为内存泄漏。误报通常源于以下场景：

1. 系统或框架的缓存机制：比如 ActivityThread 会缓存最近销毁的 Activity 实例，LeakCanary 可能误判为泄漏；
2. 合法的全局长生命周期引用：比如单例持有 Context（若持有 Application Context 是合法的，但若持有 Activity Context 且未及时释放则是真泄漏）；
3. 延迟任务未执行完成：比如 Handler.postDelayed 设置了超长延迟，LeakCanary 会认为 Activity 被 Handler 持有而误报；
4. 第三方库的内部引用：比如某些 SDK 会缓存 Context 或 View 用于后续回调，导致 LeakCanary 误判。

二、 避免误报的具体方案

1. 过滤合法的长生命周期引用（核心）

LeakCanary 支持通过 LeakCanary.Config 配置过滤规则，将明确不会造成内存泄漏的引用加入忽略列表。配置方式：在 Application 中初始化 LeakCanary 时设置过滤规则。

import leakcanary.LeakCanary; import leakcanary.ObjectInspector; public class MyApplication extends Application { @Override public void onCreate() { super.onCreate(); if (LeakCanary.isInAnalyzerProcess(this)) { return; } LeakCanary.Config config = LeakCanary.Config.DEFAULT // 1. 忽略特定类的泄漏报告 .copy( excludedRefs = LeakCanary.Config.DEFAULT.excludedRefs // 忽略系统 Activity 缓存导致的误报 .plus(LeakCanary.ExcludedRef.klazz("android.app.ActivityThread")) // 忽略第三方库的特定类 .plus(LeakCanary.ExcludedRef.klazz("com.thirdparty.sdk.SomeClass")) // 忽略特定字段的引用 .plus(LeakCanary.ExcludedRef.field("com.example.MySingleton", "sContext")) ) // 2. 延长检测阈值（避免延迟任务误报） .copy(dumpHeapThreshold = 5) // 累计 5 次泄漏才触发堆转储 // 3. 自定义对象检查器（判断对象是否真的需要被回收） .copy(objectInspectors = listOf(CustomObjectInspector())); LeakCanary.setConfig(config); } // 自定义对象检查器：判断对象是否为合法的长生命周期对象 class CustomObject