浏览器与 Web API / 系统课时
排查内存泄漏与残留监听器
排查内存泄漏与残留监听器
内存泄漏通常不是“节点没有删除”,而是节点删除后仍被监听器、定时器、观察器或业务缓存引用。本课将建立一套可重复的定位顺序,并用统一销毁函数释放资源,最终通过堆快照和重复挂载测试确认修复有效。
学习目标
- 识别脱离文档节点、残留监听器与长期引用的典型信号。
- 使用浏览器开发者工具沿保留路径定位真正的引用源。
- 为组件设计可重复调用的挂载与销毁契约。
先判断是否真的泄漏
单次内存升高不等于泄漏。脚本创建对象后,垃圾回收器可能稍后才释放;真正值得排查的是执行同一操作多轮后,已卸载组件的实例数、节点数或监听器数量持续增长,而且在垃圾回收后仍不回落。
先固定复现步骤,例如“打开弹层、关闭弹层”循环 20 次。记录操作前后的 DOM 节点数量和堆占用,再重复一轮。只有增长趋势能够稳定复现,后续堆快照才有比较价值。
按保留路径定位根因
在开发者工具中先获取基线堆快照,再完成多轮挂载与卸载,最后获取第二份快照。筛选脱离文档的节点或数量异常增长的构造函数,然后查看保留路径,确认是谁仍然持有对象。
常见保留链包括 window → 数组 → 已移除节点、全局事件目标持有回调、回调闭包持有组件状态,以及定时器或观察器持有回调。不要只删除 DOM;应沿引用链修复最上游的长期存活对象。

用销毁函数统一释放资源
组件在挂载时创建的资源,应由同一个销毁函数负责释放。事件监听器可共享 AbortSignal,定时器要保存 ID,观察器要调用 disconnect(),业务缓存要删除对应引用,最后再移除节点。
<!doctype html>
<meta charset="utf-8">
<button id="mount" type="button">挂载组件</button>
<button id="unmount" type="button">卸载组件</button>
<div id="host"></div>
<script>
const host = document.querySelector("#host");
const mountButton = document.querySelector("#mount");
const unmountButton = document.querySelector("#unmount");
let dispose = null;
function mountWidget() {
const controller = new AbortController();
const panel = document.createElement("section");
panel.innerHTML = '<button type="button">组件按钮</button>';
host.replaceChildren(panel);
// 保存定时器 ID,确保卸载时能够停止后台任务。
const timerId = setInterval(() => {
panel.dataset.tick = String(Date.now());
}, 1000);
panel.querySelector("button").addEventListener("click", () => {
console.log("组件仍在工作");
}, { signal: controller.signal });
// 多个监听器共享同一个 signal,销毁时一次性移除。
window.addEventListener("resize", () => {
panel.dataset.width = String(window.innerWidth);
}, { signal: controller.signal });
return () => {
controller.abort();
clearInterval(timerId);
panel.remove();
};
}
mountButton.addEventListener("click", () => {
dispose?.();
dispose = mountWidget();
});
unmountButton.addEventListener("click", () => {
dispose?.();
dispose = null;
console.log(`卸载完成:${host.childElementCount}`);
});
</script>依次点击“挂载组件”、组件按钮和“卸载组件”,预期输出为:
组件仍在工作
卸载完成:0卸载后继续调整窗口大小,不应再更新已移除节点;等待数秒也不应有定时任务继续修改它。再次挂载会创建新的控制器和监听器,不会复用已经中止的 signal。
验证修复是否稳定
修复后使用完全相同的复现步骤再次测试。比较两次堆快照中组件实例和脱离节点的数量;重复挂载、卸载多轮后,数量应回到稳定范围,而不是每轮累加。
还要检查监听器、定时器、MutationObserver、ResizeObserver、IntersectionObserver、订阅回调和模块级缓存。内存曲线稳定只是结果,销毁路径覆盖所有资源才是长期可维护的修复。