【Flutter】内存泄漏总结

【Flutter】内存泄漏总结

一、什么是内存泄漏（Memory Leak）

程序中某些资源（如对象、监听器、句柄等）本该释放但未释放，导致它们一直存在于内存中，即使已经不再使用，最终可能导致内存占满、App 变慢甚至崩溃。

二、Flutter 中常见的内存泄漏类型

三、排查内存泄漏的方法

1. Flutter DevTools – Memory

• 观察内存是否一直上升不下降
• 使用 Heap Snapshot 查看内存中仍然存在的对象
• 通过 Retaining Path 找出是哪里引用了未释放的对象

2. Android Studio / Xcode Instruments

• Android: 使用 Profiler 分析 native 内存使用
• iOS: Instruments 的 Leaks 工具检测未释放对象

3. 打印调试 + 日志

• 在 dispose() 里打印对象销毁标志，如：

  @override
  void dispose() {
    print("MyController disposed");
    super.dispose();
  }
  

四、具体对象和场景分类整理

1. 控制器类（必须 dispose）

2. 订阅监听类

3. 异步任务类（潜在泄漏）

4. 图片缓存泄漏

5. GlobalKey 泄漏

五、实际案例：常见泄漏代码 + 改进方式

❌ 错误：添加监听后忘记移除

final controller = TextEditingController();
controller.addListener(() {
  // update UI
});

✅ 正确处理

@override
void dispose() {
  controller.dispose(); // 自动移除 listener
  super.dispose();
}

❌ 错误：Future 回调时界面已销毁

@override
void initState() {
  super.initState();
  Future.delayed(Duration(seconds: 3), () {
    someStateChange(); // 此时 widget 可能已经销毁
  });
}

✅ 加 mounted 判断

Future.delayed(Duration(seconds: 3), () {
  if (!mounted) return;
  someStateChange();
});

六、最佳实践总结

七、辅助工具推荐

• flutter_hooks: 自动处理生命周期，简化 dispose()
• riverpod / provider: 自动释放状态
• DevTools 的 memory 工具
• leak_tracker: 社区维护的内存泄漏检测工具（实验性）

八、关于作者(ZFJ_张福杰)

• 官网：https://zfjsafe.com
• 博客：https://zfj1128.blog.csdn.net
• Github：https://github.com/zfjsyqk
• Gitee：https://gitee.com/zfj1128
• 打赏：https://zfjsafe.com/paycode