前端内存泄露检测与排查方法

前言

前端应用的内存泄露指不再使用的内存未被释放，导致页面占用内存持续增长。轻则引发页面卡顿、加载缓慢，重则导致浏览器崩溃。尤其在单页应用（SPA）中，路由切换频繁但内存不回收，问题会被无限放大。

一、前端常见的内存泄露场景

1. 意外的全局变量：未声明的变量（如 a = 10 而非 let a = 10）会挂载到 window 上，页面不刷新就不会释放；
2. 闭包滥用：闭包会保留对外部作用域的引用，若长期持有 DOM 或大型对象，会导致内存无法回收（如未清理的事件监听回调）；
3. 未清理的 DOM 引用：删除 DOM 节点后，仍保留其引用（如 let el = document.getElementById('test')，删除 el 对应的 DOM 后未置 el = null）；
4. 定时器 / 事件监听未销毁：setInterval 未用 clearInterval 清除、addEventListener 未用 removeEventListener 解绑，尤其在组件挂载 / 卸载时容易遗漏；
5. 第三方库 / 插件残留：部分第三方库（如图表库、播放器）使用后未调用销毁方法，导致内部资源无法释放；
6. 数组 / 对象无限增长：全局缓存对象未设置过期机制，或数组持续 push 数据但未清理无效项。

二、核心工具：浏览器开发者工具 (Chrome DevTools)

1. 第一步：复现内存泄露场景

首先需要稳定复现泄露行为，例如：

• 路由切换（SPA 中反复切换 A→B→A→B）；
• 点击按钮触发某操作（如打开弹窗后关闭）；
• 长时间滚动或轮询请求数据。

2. 第二步：开启 Memory 面板

1. 打开 Chrome 开发者工具；
2. 勾选面板顶部的「Memory」选项（同时可保留默认的「CPU」「Network」）；
3. 点击左上角的「录制」按钮（圆形红点），然后执行复现步骤（如切换路由 5 次）；
4. 执行完成后点击「停止」，等待面板生成报告。

关键观察点：

• 报告中 [Memory] 曲线若持续上升且不回落（即使操作停止后，内存仍未下降），则大概率存在泄露；
• 若曲线在操作后能回落至初始水平，说明内存已正常回收，无泄露。

3. 第三步：定位泄露对象

用 Memory 面板定位泄露对象，主要是用于记录页面堆内存的具体情况以及 JS 堆内存随加载时间线动态的分配情况。

常用快照类型

Memory 面板支持 3 种快照类型，按需选择：

• Heap snapshot（堆快照）：捕获当前内存中所有对象的快照，可对比不同快照的差异，适合定位未回收的对象；
• Allocation instrumentation on timeline（时间线分配记录）：实时记录内存分配过程，适合观察某操作期间的内存分配细节；
• Allocation sampling（分配采样）：低开销的内存采样，适合快速排查大面积泄露，无需精确到单个对象。

堆快照对比操作

1. 打开 DevTools → 切换到「Memory」面板；
2. 选择「Heap snapshot」，点击「Take snapshot」拍摄初始快照（记为快照 1，此时未执行任何操作）；
3. 执行一次泄露复现步骤（如切换一次路由）；
4. 再次点击「Take snapshot」拍摄快照 2；
5. 重复复现步骤 N 次（如再切换 3 次路由），拍摄快照 3；
6. 在 Memory 面板左侧的快照列表中，点击快照 2/3 的下拉框，选择「Comparison」（对比），并选择'与快照 1 对比'。

通过对比可以看出变占用的内存大小，是哪些操作造成了内存泄露。

堆快照就像照相机一样，能记录你当前页面的堆内存情况，每快照一次就会产生一条快照记录。

如上图所示，刚开始执行了一次快照，记录了当时堆内存空间占用为 59.4MB，然后我们点击了页面中某些按钮，又执行一次快照，记录了当时堆内存空间占用为 59.7MB。并且点击对应的快照记录，能看到当时所有内存中的变量情况（结构、占总占用内存的百分比...）。

在开始记录后，我们可以看到图中右上角有起伏的蓝色与灰色的柱形图，其中蓝色表示当前时间线下占用着的内存；灰色表示之前占用的内存空间已被清除释放。

使用 Allocation on timeline：

三、示例

1. 闭包使用不当引起内存泄漏

使用 Performance 和 Memory 来查看一下闭包导致的内存泄漏问题。在退出 fn1 函数执行上下文后，该上下文中的变量 a 本应被当作垃圾数据给回收掉，但因 fn1 函数最终将变量 a 返回并赋值给全局变量 res，其产生了对变量 a 的引用，所以变量 a 被标记为活动变量并一直占用着相应的内存。假设变量 res 后续用不到，这就算是一种闭包使用不当的例子。

设置了一个按钮，每次执行就会将 fn1 函数的返回值添加到全局数组变量 res 中，是为了能在 Performance 的曲线图中看出效果。

录制的时候去执行 fn1 函数。

• 在每次录制开始时手动触发一次垃圾回收机制，这是为了确认一个初始的堆内存基准线，便于后面的对比。然后我们点击了几次按钮，即往全局数组变量 res 中添加了几个比较大的数组对象，最后再触发一次垃圾回收，发现录制结果的 JS Heap 曲线刚开始成阶梯式上升的，最后的曲线的高度比基准线要高，说明可能是存在内存泄漏的问题；
• 在得知有内存泄漏的情况存在时，我们可以改用 Memory 来更明确得确认问题和定位问题；
• 首先可以用 Allocation instrumentation on timeline 来确认问题，如下图所示：

先选择这个，然后去录制。

在我们每次点击按钮后，动态内存分配情况图上都会出现一个蓝色的柱形，并且在我们触发垃圾回收后，蓝色柱形都没变成灰色柱形，即之前分配的内存并未被清除。

所以此时我们就可以更明确得确认内存泄露的问题是存在的了。接下来就精准定位问题，可以利用 Heap snapshot 来定位问题，如图所示：

• 第一次先点击快照记录初始的内存情况，然后我们多次点击按钮后再次点击快照，记录此时的内存情况，发现从原来的 1.2 M 内存空间变成了 1.7 M 内存空间。然后我们选中第二条快照记录，可以看到右上角有个 All objects 的字段，其表示展示的是当前选中的快照记录所有对象的分配情况。而我们想要知道的是第 5 条快照与第一条快照的区别在哪，所以选择 Object allocated between Snapshot1 and Snapshot2 即展示第一条快照和第二条快照存在差异的内存对象分配情况。此时可以看到 Array 的百分比很高，初步可以判断是该变量存在问题，点击查看详情后就能查看到该变量对应的具体数据了。

以上就是一个判断闭包带来内存泄漏问题并简单定位的方法了。

2. 全局变量

全局的变量一般是不会被垃圾回收掉的。当然这并不是说变量都不能存在全局，只是有时候会因为疏忽而导致某些变量流失到全局，例如未声明变量，却直接对某变量进行赋值，就会导致该变量在全局创建，如下所示：

function fn1() { // 此处变量 name 未被声明
    name = new Array(99999999)
}
fn1()

• 此时这种情况就会在全局自动创建一个变量 name，并将一个很大的数组赋值给 name，又因为是全局变量，所以该内存空间就一直不会被释放；
• 解决办法的话，自己平时要多加注意，不要在变量未声明前赋值，或者也可以开启严格模式，这样就会在不知情犯错时，收到报错警告。

3. 分离的 DOM 节点

假设你手动移除了某个 dom 节点，本应释放该 dom 节点所占用的内存，但却因为疏忽导致某处代码仍对该被移除节点有引用，最终导致该节点所占内存无法被释放，例如这种情况：

<div>
  <div>我是子元素</div>
  <button>移除</button>
</div>
<script>
  let btn = document.querySelector('button')
  let child = document.querySelector('.child')
  let root = document.querySelector('#root')
  btn.addEventListener('click', function() {
    root.removeChild(child)
  })
</script>

该代码所做的操作就是点击按钮后移除.child 的节点，虽然点击后，该节点确实从 dom 被移除了，但全局变量 child 仍对该节点有引用，所以导致该节点的内存一直无法被释放。可以尝试用 Memory 的快照功能来检测一下，如图所示。

同样的先记录一下初始状态的快照，然后点击移除按钮后，再点击一次快照，此时内存大小我们看不出什么变化，因为移除的节点占用的内存实在太小了可以忽略不计。但我们可以点击第二条快照记录，在筛选框里输入 detached，于是就会展示所有脱离了却又未被清除的节点对象。

解决办法如下图所示：

<div>
  <div>我是子元素</div>
  <button>移除</button>
</div>
<script>
  let btn = document.querySelector('button')
  btn.addEventListener('click', function() {
    let child = document.querySelector('.child')
    let root = document.querySelector('#root')
    root.removeChild(child)
  })
</script>

改动很简单，就是将对.child 节点的引用移动到了 click 事件的回调函数中，那么当移除节点并退出回调函数的执行上下文后就会自动清除对该节点的引用，那么自然就不会存在内存泄漏的情况了。我们来验证一下，如下图所示：

结果很明显，这样处理过后就不存在内存泄露的情况了。

4. 控制台打印

我们在按钮的点击回调事件中创建了一个很大的数组对象并打印，用 performance 来验证一下。

开始录制，先触发一次垃圾回收清除初始的内存，然后点击三次按钮，即执行了三次点击事件，最后再触发一次垃圾回收。查看录制结果发现 JS Heap 曲线成阶梯上升，并且最终保持的高度比初始基准线高很多，这说明每次执行点击事件创建的很大的数组对象 obj 都因为 console.log 被浏览器保存了下来并且无法被回收。

接下来注释掉 console.log，再来看一下结果：

<button>按钮</button>
<script>
  document.querySelector('button').addEventListener('click', function() {
    let obj = new Array(1000000)
    // console.log(obj);
  })
</script>

可以看到没有打印以后，每次创建的 obj 都立马被销毁了，并且最终触发垃圾回收机制后跟初始的基准线同样高，说明已经不存在内存泄漏的现象了。

5. 遗忘的定时器

定时器也是平时很多人会忽略的一个问题，比如定义了定时器后就再也不去考虑清除定时器了，这样其实也会造成一定的内存泄漏。来看一个代码示例：

<button>开启定时器</button>
<script>
  function fn1() {
    let largeObj = new Array(100000)
    setInterval(() => {
      let myObj = largeObj
    }, 1000)
  }
  document.querySelector('button').addEventListener('click', function() {
    fn1()
  })
</script>

这段代码是在点击按钮后执行 fn1 函数，fn1 函数内创建了一个很大的数组对象 largeObj，同时创建了一个 setInterval 定时器，定时器的回调函数只是简单的引用了一下变量 largeObj。我们来看看其整体的内存分配情况吧：

按道理来说点击按钮执行 fn1 函数后会退出该函数的执行上下文，紧跟着函数体内的局部变量应该被清除，但图中 performance 的录制结果显示似乎是存在内存泄漏问题的，即最终曲线高度比基准线高度要高。那么再用 Memory 来确认一次：

• 在我们点击按钮后，从动态内存分配的图上看到出现一个蓝色柱形，说明浏览器为变量 largeObj 分配了一段内存，但是之后这段内存并没有被释放掉，说明的确存在内存泄漏的问题。原因其实就是因为 setInterval 的回调函数内对变量 largeObj 有一个引用关系，而定时器一直未被清除，所以变量 largeObj 的内存也自然不会被释放；
• 那么我们如何来解决这个问题呢？假设我们只需要让定时器执行三次就可以了，那么我们可以改动一下代码。

现在我们再通过 performance 和 memory 来看看还不会存在内存泄漏的问题。

• Performance

• Memory

后我们点击了按钮，看到又出现了一个蓝色柱形，此时就是为 fn1 函数中的变量 largeObj 分配了内存，3s 后该内存又被释放了，即变成了灰色柱形。所以我们可以得出结论，这段代码不存在内存泄漏的问题。