内存泄漏排查方法
Vue 项目出现内存泄漏可能会导致页面响应变慢、浏览器占用内存不断增加等问题。常见的内存泄漏来源包括:未销毁的定时器、未移除的事件监听、未清理的全局变量、组件未正确卸载等。下面是排查和解决方案:
- 使用 Chrome DevTools 监测内存变化
步骤:
-
打开 Chrome 开发者工具 → 进入 Performance 或 Memory 面板。
-
录制内存快照(Heap Snapshot):
快照 1:进入特定页面,记录内存状态。
快照 2:操作一段时间后,再次记录内存状态。
快照 3:离开页面,等待 GC(垃圾回收),再记录一次。
对比快照:如果对象未释放,可能存在内存泄漏。
- 在 Profiles 选项卡的 Heap Snapshot 中,查看 Detached DOM 是否不断增加。
- 定位常见的 Vue 内存泄漏问题
(1)定时器未清除(setInterval / setTimeout)
Vue 组件销毁时,如果未清除 setInterval,则它仍然在运行,导致内存泄漏:
解决方案: 在 onUnmounted 中清除定时器。
(2)事件监听未移除
在 mounted 中添加 addEventListener,但未在 unmounted 时移除,会导致内存泄漏:
解决方案: 确保在组件销毁时移除事件监听。
(3)Vue 组件缓存导致的内存泄漏
如果使用 keep-alive,但子组件在 unmounted 时未正确清理,可能导致内存泄漏:
解决方案: 如果组件需要彻底销毁,避免使用 keep-alive 或在 onDeactivated 里清理状态。
(4)Vuex / Pinia / 全局变量未清理
如果 Vuex/Pinia 存储了不必要的对象,可能会导致内存无法释放:
const store = useStore();
store.data = someLargeObject; // 组件销毁后仍然存在
解决方案:
- 在组件 onUnmounted 时,重置 Vuex / Pinia 状态:
onUnmounted(() => {
store.$reset();
});
- 避免存储大型对象,如果可能,存储对象的 ID 而不是完整对象。
(5)第三方库未正确卸载
例如,echarts 或 mapbox 这类库如果在组件销毁时未正确释放,会导致内存泄漏:
解决方案: 在 onUnmounted 时手动 dispose()。
- 使用 WeakMap / WeakSet 避免长期引用
如果有动态注册的对象,使用 WeakMap 代替 Map,因为 WeakMap 中的对象可以被垃圾回收:
const cache = new WeakMap();
function storeData(key, value) {
cache.set(key, value);
}
function removeData(key) {
cache.delete(key);
}
这样 WeakMap 中的对象不会阻止垃圾回收。
- 总结 Vue 内存泄漏排查步骤
✅ 1. 使用 Chrome DevTools (Performance & Memory 面板) 检测内存变化。
✅ 2. 检查未清理的 setTimeout / setInterval,在 onUnmounted 里清除。
✅ 3. 确保 addEventListener 绑定的事件在 onUnmounted 里移除。
✅ 4. 如果使用 keep-alive,要在 onDeactivated 里释放资源。
✅ 5. Vuex / Pinia 在 onUnmounted 时重置数据,避免存储大对象。
✅ 6. 第三方库(如 ECharts、Mapbox)在 onUnmounted 里调用 dispose()。
✅ 7. 使用 WeakMap / WeakSet 避免长期持有对象。
这样可以有效防止 Vue 项目中的内存泄漏问题。你遇到过类似问题吗?