如何强制Node.js执行垃圾回收 解决Jest测试堆内存溢出问题

你观察到的内存占用100%、磁盘占用100%、CPU仅4%的状态，是Node堆内存耗尽后触发系统虚拟内存swap交换导致的——系统将硬盘空间作为临时内存使用，硬盘IO被占满但实际计算进程几乎处于停滞状态，和你之前猜测的“内存不足导致进程暂停”完全吻合。
这个场景下的内存压力核心来源不是被测代码的GC不工作，而是Jest的test.each实现机制：它会在测试套件初始化阶段，把你传入的所有参数化用例数据全部预加载、序列化后常驻内存，不会随单条用例执行完成释放。你传入数万到数十万条数据时，光存储这些用例元数据、生成用例标题就会占用数GB内存，单纯调大堆内存、手动GC都没法从根源解决初始化阶段的内存峰值问题。

如果确实需要在测试过程中手动触发GC，按以下步骤操作即可：

• 启动Jest时增加--expose-gc启动参数，暴露Node底层的GC调用接口，启动命令参考：
  NODE_OPTIONS='--max-old-space-size=4096 --expose-gc' jest --logHeapUsage

注意：--max-old-space-size不要设置超过机器物理内存的70%，否则会触发swap卡死，你之前设置8192如果机器物理内存不足8G，必然会出现硬盘跑满的问题。

• 在测试的生命周期钩子里手动调用GC，建议在每跑完一批用例后触发，避免无效的GC性能损耗，示例代码：

// 每跑完100条用例触发一次GC
let caseCount = 0
afterEach(() => {
  caseCount++
  if (caseCount % 100 === 0 && global.gc) {
    global.gc()
  }
})

手动调用GC会短暂阻塞进程，仅适合测试场景临时使用，不要在生产业务代码中调用。

靠手动GC无法完全解决你当前的卡死问题，需要配合以下调整：

• 不要把全量几十万条数据直接传入test.each：改为在单个test块内部循环遍历数据集，每处理固定批次数据就触发一次GC，避免test.each预加载全量数据带来的初始化内存峰值
• 拆分大测试集为多个小测试文件：Jest默认会启动多worker进程并行跑不同测试文件，单个worker跑完对应文件后会直接退出，占用的内存会被操作系统完全回收，比单进程内靠GC回收内存效率高得多
• 大压力测试场景下移除--detectOpenHandles参数：该参数会持有测试过程中所有句柄的引用直到整个测试套件结束，会直接阻止GC回收关联资源，本身就会放大内存占用问题
• 如果不需要生成每条用例的独立测试报告，可以用test.concurrent搭配分批加载数据的方式，进一步降低单进程内存压力

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