如何修复Android自定义MapLegendView引发的内存泄漏？

现存问题 #

内存泄漏修复新手在MapPageFragment中使用自定义MapLegendView时触发泄漏，尝试了三类操作均未解决问题：

• 在Fragment销毁节点将View相关引用手动置空
• 在MapPageFragment的onDestroyView方法中手动调用MapLegendView的onDetachedFromWindow方法
• 对自定义View持有的Context使用WeakReference包装

第一步：跳过无效操作，顺着LeakCanary链路逐环定位 #

不要上来就套通用修复模板，先沿着LeakCanary输出的从GC Root到泄漏的MapLegendView实例的完整引用链，逐环确认每一个强引用的持有方，自定义View类的泄漏90%集中在以下几个环点：

• 全局单例/SDK/事件总线未反注册View的回调：自定义View在初始化时给地图SDK、全局事件总线、主题切换管理器、手势识别器注册了监听，页面销毁时没有调用对应反注册方法移除监听，导致全局对象一直持有View的强引用
• 异步任务/动画未取消：View在onAttachedToWindow流程中启动了未绑定View生命周期的属性动画、主线程Handler延迟消息、协程/线程任务，这些任务的匿名内部类会隐式持有View实例，页面销毁时任务仍在执行，导致引用链无法断开
• 全局观察者未移除：View通过View.getViewTreeObserver()注册了全局布局、滚动回调监听，detach时没有移除，导致ViewTreeObserver一直持有View引用
• 静态变量误持有View：代码中存在静态字段直接赋值MapLegendView实例的写法，静态变量属于GC Root，会导致View实例永远无法回收

之前尝试的操作不生效的核心原因：

1. 手动置空Fragment侧的View引用，不会影响全局对象对View的强引用，只要引用链还有一环通到GC Root，对象就不会被回收
2. 手动调用onDetachedFromWindow不会触发系统的完整解绑流程，也不会自动清除View之前注册的所有全局监听
3. 弱引用Context仅能切断View到Context的引用，挡不住其他对象直接持有View实例的泄漏链路

第二步：针对MapLegendView场景的定向修复 #

所有清理逻辑统一写在MapLegendView重写的onDetachedFromWindow方法中，等View真正从Window移除时由系统自动触发执行，不要手动调用：

• 全量移除注册的监听：把所有初始化时给全局管理器、SDK、事件总线、ViewTreeObserver注册的回调，全部通过对应API反注册，传入和注册时完全一致的监听对象
• 清理未完成的任务：
  • 调用clearAnimation()停止所有正在运行的属性动画
  • 给View内部持有的主线程Handler发送removeCallbacksAndMessages(null)，清空所有待执行的延迟消息和任务
  • 取消所有绑定在View生命周期上的协程、异步线程任务
• 解绑跨层级引用：检查MapLegendView是否被传给了地图引擎、Fragment的ViewModel、全局单例等长生命周期对象，在detach时主动调用对应的解绑API，移除这些长生命周期对象上的View引用

避坑提醒 #

• 不要给View实例本身套弱引用：View是UI层级的核心组件，被回收时会直接导致UI崩溃，无法从根上解决泄漏
• 不要把弱引用Context当万能修复手段：它仅能解决View持有Activity Context的场景，对其他持有View的泄漏链路完全无效
• 不要在ViewModel中持有View实例：ViewModel的生命周期长于页面View层级，一旦持有View强引用，会直接导致整个View层级泄漏

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