LeakCanary Kotlin 内存泄漏检测：完整指南与代码示例

在 Android 开发中，内存管理是最关键的挑战之一。内存泄漏（memory leaks）是指应用程序不再需要的对象，由于隐式引用而继续占用内存。这会导致内存消耗增加、频繁的 GC（垃圾回收）暂停、卡顿，最终引发 OutOfMemoryError 和应用崩溃。LeakCanary 是 Square 公司开发的开源库，能够自动检测 Java 和 Kotlin Android 应用中的内存泄漏。

为什么需要它？手动调试内存泄漏是一个复杂且耗时的过程，需要深入理解 JVM、分析堆转储（heap dumps）以及使用性能分析工具（如 Android Studio Profiler、MAT）。LeakCanary 接管了所有这些工作：它会自动监控 Activity、Fragment、ViewModel 及其他组件的生命周期，如果某个组件在销毁后未被垃圾回收器回收，该库会创建堆转储、分析它，并为你生成一份完整的报告，明确指出导致泄漏的引用链。这让开发者能够快速定位并修复问题，无需花费数小时进行手动分析。

LeakCanary 以库的形式集成到应用中，并在后台运行。它不会影响用户体验，但会向开发者（在 debug 构建中）发送通知和详细日志。从 2.x 版本开始，该库已完全用 Kotlin 重写，性能更高且更易于使用。它支持最新的 Android 架构组件（Jetpack），并允许自定义泄漏检测流程。

安装

LeakCanary 通过 Maven Central 分发。要安装它，请将依赖项添加到模块的 build.gradle.kts（或 build.gradle）文件中。

重要提示：LeakCanary 仅用于 debug 构建。切勿将其包含在 release 版本的应用中，否则可能对性能和安全性产生负面影响。

// build.gradle.kts (Module :app)
dependencies {
    // debugImplementation — 该库仅在 debug 构建中可用
    debugImplementation("com.squareup.leakcanary:leakcanary-android:2.14")
    
    // 支持 Jetpack Navigation（可选）
    debugImplementation("com.squareup.leakcanary:leakcanary-android-navigation:2.14")
    
    // 支持 Process Lifecycle（可选）
    debugImplementation("com.squareup.leakcanary:leakcanary-android-process:2.14")
}

Gradle 同步后，LeakCanary 会在应用启动时自动注册其 ContentProvider。无需在代码中进行任何额外的初始化。

快速入门

最简单的使用方式就是安装该库。之后，LeakCanary 会自动检测内存泄漏。

1. 按照上述步骤安装库。

2. 在 debug 模式下运行应用。

3. 执行可能引发泄漏的操作（例如，如果存在 Activity 泄漏，旋转屏幕）。

4. 如果检测到泄漏，你会看到系统通知：

5. 点击通知，打开包含详细报告（堆转储信息）的界面。

以下示例代码会制造一个泄漏用于测试：

// 泄漏示例：静态引用 Activity
class LeakyActivity : AppCompatActivity() {
    companion object {
        // 静态引用会阻止 Activity 被 GC 回收
        var leakedActivity: Activity? = null
    }

    override fun onCreate(savedInsta