如何在自动化测试套件中检测Node.js应用是否存在内存泄漏？

我是PostgreSQL库slonik的作者，想确保简单查询不会导致内存泄漏。虽然有不少工具可以检查内存泄漏，但关于如何创建自动化测试来确保无内存泄漏的文档和示例却很少。

我的思路是：重复运行某一查询X次，检查JavaScript对象、字符串、闭包等的内存使用是否保持稳定。我尝试用process.memoryUsage()写了一个简单测试来验证可行性：

const measureMemory = (routine) => {
  const before = process.memoryUsage();

  routine();

  const after = process.memoryUsage();

  console.log('heap used: ' + ((after.heapUsed - before.heapUsed) / 1024 / 1024).toFixed(2) + ' MB');
};

measureMemory(() => {});

measureMemory(() => {
  let largeArray = [];

  for (let index = 0; index < 10000000; index++) {
    largeArray.push({ number: index });
  }

  largeArray = null;
});

measureMemory(() => {});

我预期的输出是：

heap used: 0.00 MB
heap used: 0.00 MB
heap used: 0.00 MB

但实际输出却是：

heap used: 0.00 MB
heap used: 577.52 MB
heap used: 0.00 MB

显然我忽略了关键因素，大概率是垃圾回收的问题。请问设计这类内存测试的正确方法是什么？

你的判断没错，问题核心就是Node.js的垃圾回收（GC）是自动触发的，不会在你设置largeArray = null后立刻执行，导致第二次测量时堆内存还没被释放。要设计可靠的内存泄漏测试，需要主动控制GC时机，同时调整测试逻辑，确保测量的准确性。

1. 启用显式GC（仅测试环境） #

Node.js默认禁用了显式GC调用，需要在启动时加上--expose-gc参数，允许代码中调用global.gc()。

2. 优化内存测量逻辑 #

• 在测量前先触发GC，清理旧的垃圾
• 重复多次执行被测逻辑，减少单次执行的误差
• 等待GC完成后再进行内存统计
• 多次测量取平均值，避免GC时机的偶然影响

改进后的测试代码示例 #

const measureMemory = async (routine, iterations = 1) => {
  // 先执行一次GC，清理测试环境残留
  global.gc();
  await new Promise(resolve => setImmediate(resolve)); // 等待GC执行完成

  const before = process.memoryUsage();

  // 重复执行被测逻辑，放大内存变化
  for (let i = 0; i < iterations; i++) {
    routine();
  }

  // 执行GC清理本次逻辑产生的垃圾
  global.gc();
  await new Promise(resolve => setImmediate(resolve));

  const after = process.memoryUsage();

  const heapUsedDiff = (after.heapUsed - before.heapUsed) / 1024 / 1024;
  console.log(`heap used after ${iterations} iterations: ${heapUsedDiff.toFixed(2)} MB`);
  
  return heapUsedDiff;
};

// 测试空函数
await measureMemory(() => {});

// 测试大数组创建与释放
await measureMemory(() => {
  let largeArray = [];
  for (let index = 0; index < 10000000; index++) {
    largeArray.push({ number: index });
  }
  largeArray = null;
});

// 再次测试空函数
await measureMemory(() => {});

3. 针对数据库查询的内存测试要点 #

对于slonik的查询测试，你需要：

• 复用数据库连接，避免连接创建的内存开销干扰测试结果
• 重复执行相同的查询（比如1000次以上），放大潜在的泄漏问题
• 确保每次查询完成后释放所有相关资源（比如结果集、临时对象）
• 对比多轮循环后的内存变化：如果内存使用稳定在固定区间，无持续增长，说明无泄漏；如果每次循环后内存都有明显增长，就需要排查泄漏点

4. 辅助验证工具 #

除了自动化测试，还可以用这些工具辅助排查：

• Chrome DevTools：通过node --inspect启动进程，在Chrome中连接后使用Memory面板拍摄堆快照，对比多次查询后的对象残留
• clinic.js：Node.js官方性能诊断工具集，其中clinic heap-profiler可以直观展示内存使用趋势

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