Android 内存泄漏排查实战：从 LeakCanary 报警到根因定位

2026-09-02 8

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 本文详解Android内存泄漏实战排查：基于LeakCanary报警快速定位HomeActivity等泄漏根因，覆盖Handler、单例Context、AsyncTask、LiveData、Bitmap五大高频场景，提供静态内部类+弱引用、lifecycleScope、ApplicationContext精准修复方案

Android 内存泄漏排查实战：从 LeakCanary 报警到根因定位

前言

线上突然收到 OOM 崩溃告警，内存曲线持续上涨不回落，用户反馈"用久了就卡"。这种场景下，内存泄漏往往是第一嫌疑人。本文从一次真实的泄漏排查过程出发，讲清楚如何用 LeakCanary 快速定位泄漏源，以及常见泄漏场景的根因与修复手法。

问题现场：LeakCanary 报了什么

集成 LeakCanary 后，打开应用几分钟就弹出通知：

┬───
│ GC Root: Local variable in thread
│
├─ android.os.HandlerThread instance
│    thread name: 'LeakCanary-Heap-Dump'
│
├─ android.os.Handler instance
│
├─ com.example.ui.HomeActivity$1 (anonymous class)
│    holding MainActivity instance
│
╰→ com.example.ui.HomeActivity instance
     Leaking: YES (Activity#mDestroyed=true)

关键信息：

泄漏对象：HomeActivity 实例
GC Root：匿名内部类持有 Activity 引用
泄漏原因：Activity 已销毁（mDestroyed=true），但仍被 Handler 持有

场景一：Handler 匿名内部类持有 Activity

问题代码

class HomeActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // ❌ 匿名内部类持有外部 Activity 引用
        Handler(Looper.getMainLooper()).postDelayed({
            findViewById<TextView>(R.id.tvTitle).text = "更新"
        }, 10000)

        // 用户 3 秒后退出 Activity，但 Handler 消息 10 秒后才执行
        // Activity 实例被 Handler 持有 7 秒无法回收
    }
}

泄漏原因

Lambda 或匿名内部类会隐式持有外部类（Activity）的引用
Handler 消息队列持有 Runnable
Activity 销毁时，消息未执行完，Activity 无法被 GC

修复方案

方案 A：静态内部类 + 弱引用

class HomeActivity : AppCompatActivity() {
    private val handler = SafeHandler(this)

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        handler.sendEmptyMessageDelayed(1, 10000)
    }

    override fun onDestroy() {
        super.onDestroy()
        handler.removeCallbacksAndMessages(null) // 清空消息队列
    }

    class SafeHandler(activity: HomeActivity) : Handler(Looper.getMainLooper()) {
        private val activityRef = WeakReference(activity)

        override fun handleMessage(msg: Message) {
            activityRef.get()?.apply {
                findViewById<TextView>(R.id.tvTitle).text = "更新"
            }
        }
    }
}

方案 B：Lifecycle 感知的 Handler（推荐）

class HomeActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        lifecycleScope.launch {
            delay(10000)
            if (lifecycle.currentState.isAtLeast(Lifecycle.State.STARTED)) {
                findViewById<TextView>(R.id.tvTitle).text = "更新"
            }
        }
    }
}

场景二：单例持有 Activity Context

问题代码

object ImageLoader {
    private var context: Context? = null

    fun init(context: Context) {
        this.context = context // ❌ 如果传入 Activity，单例会一直持有
    }

    fun loadImage(url: String, view: ImageView) {
        context?.let {
            Glide.with(it).load(url).into(view)
        }
    }
}

// Activity 中调用
ImageLoader.init(this) // ❌ 传入 Activity Context

泄漏原因

单例生命周期 = 应用生命周期
持有 Activity Context 后，Activity 无法释放
内存中可能存在多个已销毁的 Activity 实例

修复方案

object ImageLoader {
    private lateinit var appContext: Context

    fun init(context: Context) {
        // ✅ 转为 ApplicationContext
        this.appContext = context.applicationContext
    }

    fun loadImage(url: String, view: ImageView) {
        // Glide.with() 会自动处理生命周期
        Glide.with(view.context).load(url).into(view)
    }
}

核心原则：

单例、静态变量只持有 ApplicationContext
需要 Activity Context 的场景，通过参数传入，不存储

场景三：非静态内部类 + 异步任务

问题代码

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // ❌ 非静态内部类持有外部 Activity
        DataTask().execute()
    }

    inner class DataTask : AsyncTask<Void, Void, String>() {
        override fun doInBackground(vararg params: Void?): String {
            Thread.sleep(10000) // 模拟耗时操作
            return "result"
        }

        override fun onPostExecute(result: String) {
            // Activity 可能已销毁，但仍被 Task 持有
            findViewById<TextView>(R.id.tvResult).text = result
        }
    }
}

修复方案

class MainActivity : AppCompatActivity() {
    private var job: Job? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // ✅ 使用 lifecycleScope，自动取消
        job = lifecycleScope.launch {
            val result = withContext(Dispatchers.IO) {
                delay(10000)
                "result"
            }
            findViewById<TextView>(R.id.tvResult).text = result
        }
    }

    override fun onDestroy() {
        super.onDestroy()
        job?.cancel() // 手动取消也可
    }
}

场景四：LiveData/Flow 观察者未移除

问题代码

class ProfileActivity : AppCompatActivity() {
    private val viewModel: UserViewModel by viewModels()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // ❌ 使用 observeForever，未在 onDestroy 中移除
        viewModel.userLiveData.observeForever { user ->
            findViewById<TextView>(R.id.tvName).text = user.name
        }
    }
}

泄漏原因

observeForever 不会自动移除观察者
LiveData 持有 Observer，Observer 持有 Activity

修复方案

class ProfileActivity : AppCompatActivity() {
    private val viewModel: UserViewModel by viewModels()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // ✅ 使用 observe(lifecycleOwner)，自动清理
        viewModel.userLiveData.observe(this) { user ->
            findViewById<TextView>(R.id.tvName).text = user.name
        }
    }
}

场景五：Bitmap 未回收

问题代码

class ImageActivity : AppCompatActivity() {
    private var bitmap: Bitmap? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        bitmap = BitmapFactory.decodeResource(resources, R.drawable.large_image)
        findViewById<ImageView>(R.id.ivImage).setImageBitmap(bitmap)

        // ❌ Activity 销毁时未回收 Bitmap
    }
}

修复方案

class ImageActivity : AppCompatActivity() {
    private var bitmap: Bitmap? = null

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        bitmap = BitmapFactory.decodeResource(resources, R.drawable.large_image)
        findViewById<ImageView>(R.id.ivImage).setImageBitmap(bitmap)
    }

    override fun onDestroy() {
        super.onDestroy()
        bitmap?.recycle() // ✅ 手动回收
        bitmap = null
    }
}

更好的方案：使用 Glide/Coil 等图片库，自动管理生命周期。

LeakCanary 集成与配置

基础集成

dependencies {
    debugImplementation 'com.squareup.leakcanary:leakcanary-android:2.12'
}

无需其他配置，debug 包自动启用。

自定义配置

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        LeakCanary.config = LeakCanary.config.copy(
            retainedVisibleThreshold = 3, // 保留 3 个对象后才触发 dump
            dumpHeap = true,
            dumpHeapWhenDebugging = false, // 调试时不 dump
            leakingObjectFinder = FilteringLeakingObjectFinder(
                AndroidObjectInspectors.appLeakingObjectFilters
            )
        )
    }
}

过滤已知系统泄漏

LeakCanary.config = LeakCanary.config.copy(
    referenceMatchers = AndroidReferenceMatchers.appDefaults +
        IgnoredReferenceMatcher(
            pattern = "com.android.internal.policy.DecorView.mContext"
        )
)

排查流程总结

集成 LeakCanary：debug 包自动检测
复现场景：打开关键页面，退出，等待通知
分析 Trace：找到 GC Root → 泄漏对象的引用链
定位代码：查看持有引用的类（匿名类/单例/静态变量）
修复验证：修改后重新测试，确认不再报警
线上监控：接入性能监控平台（Firebase Performance / 腾讯 Matrix）

常见泄漏场景速查表

场景	泄漏原因	修复方案
Handler 延时任务	匿名类持有 Activity	静态类+弱引用 / lifecycleScope
单例持有 Context	单例生命周期 > Activity	使用 ApplicationContext
AsyncTask / Thread	非静态内部类	静态类+弱引用 / Coroutine
LiveData observeForever	未移除观察者	使用 observe(lifecycleOwner)
事件监听器未注销	全局 EventBus/监听器	onDestroy 中反注册
Bitmap 未回收	大对象占用内存	onDestroy 中 recycle()
WebView 未清理	WebView 持有 Activity	onDestroy 中 destroy()

进阶技巧

1. 手动触发 Heap Dump

// 测试环境手动触发
LeakCanary.dumpHeap()

2. 自定义泄漏检测

class MyFragment : Fragment() {
    override fun onDestroy() {
        super.onDestroy()
        // 检测自定义对象是否泄漏
        AppWatcher.objectWatcher.watch(
            watchedObject = customObject,
            description = "CustomObject should be GC'd"
        )
    }
}

3. CI 环境集成

androidTestImplementation 'com.squareup.leakcanary:leakcanary-android-instrumentation:2.12'

@Test
fun testNoLeaks() {
    val scenario = launchActivity<MainActivity>()
    scenario.close()

    // 断言无泄漏
    val leaks = LeakCanary.detectLeaks()
    assertThat(leaks).isEmpty()
}

总结

内存泄漏排查的核心是理解对象生命周期：

Activity/Fragment 生命周期短，不应被长生命周期对象持有
匿名类/非静态内部类会隐式持有外部类引用
异步任务/监听器/观察者需要在合适时机清理
使用 Jetpack 组件（ViewModel/LiveData/Coroutine）可自动处理大部分场景

LeakCanary 是快速定位的利器，但真正的修复需要理解引用链和生命周期关系。养成"谁创建谁清理"的习惯，大部分泄漏都能在编码阶段避免。

Android 内存泄漏排查实战：从 LeakCanary 报警到根因定位

Android 内存泄漏排查实战：从 LeakCanary 报警到根因定位

前言

问题现场：LeakCanary 报了什么

场景一：Handler 匿名内部类持有 Activity

问题代码

泄漏原因

修复方案

场景二：单例持有 Activity Context

问题代码

泄漏原因

修复方案

场景三：非静态内部类 + 异步任务

问题代码

修复方案

场景四：LiveData/Flow 观察者未移除

问题代码

泄漏原因

修复方案

场景五：Bitmap 未回收

问题代码

修复方案

LeakCanary 集成与配置

基础集成

自定义配置

过滤已知系统泄漏

排查流程总结

常见泄漏场景速查表

进阶技巧

1. 手动触发 Heap Dump

2. 自定义泄漏检测

3. CI 环境集成

总结

热门文章

最新文章

相关电子书

探索云世界

热门

云计算

大数据

云原生

人工智能

数据库

开发与运维

活动广场

任务中心

训练营

直播

乘风者计划

下载

镜像站

技术资料

Android 内存泄漏排查实战：从 LeakCanary 报警到根因定位

Android 内存泄漏排查实战：从 LeakCanary 报警到根因定位

前言

问题现场：LeakCanary 报了什么

场景一：Handler 匿名内部类持有 Activity

问题代码

泄漏原因

修复方案

场景二：单例持有 Activity Context

问题代码

泄漏原因

修复方案

场景三：非静态内部类 + 异步任务

问题代码

修复方案

场景四：LiveData/Flow 观察者未移除

问题代码

泄漏原因

修复方案

场景五：Bitmap 未回收

问题代码

修复方案

LeakCanary 集成与配置

基础集成

自定义配置

过滤已知系统泄漏

排查流程总结

常见泄漏场景速查表

进阶技巧

1. 手动触发 Heap Dump

2. 自定义泄漏检测

3. CI 环境集成

总结

热门文章

最新文章

相关电子书