Node.js中如何释放已加载模块占用的内存？

问题核心原因 #

你遇到的问题本质是两点：

1. require缓存与引用残留：Node.js的require会将模块缓存到require.cache中，即便删除缓存，若模块内部存在全局引用、闭包、定时器或事件监听器，这些残留引用会阻止V8垃圾回收（GC）释放模块内存。
2. V8堆内存的惰性收缩：total_heap_size是V8预分配的堆空间，GC后不会立即收缩——它会保留已分配空间以避免后续内存分配的开销，实际使用内存需看used_heap_size指标。

有效解决方案 #

1. 彻底清除所有引用（基础场景） #

如果模块无全局依赖或持久化引用，可通过以下步骤释放内存：

• 移除模块在require.cache中的缓存
• 确保模块导出对象无变量持有
• 手动触发GC（需启动时加--expose-gc参数）

修改后的示例代码：

const Koa = require('koa');
const V8 = require('v8');
const app = new Koa();

app.use(async ctx => {
  if (ctx.request.href.includes('module1')){
    const modulePath = require.resolve('./large-module');
    let data = require(modulePath);
    console.log(V8.getHeapStatistics());
    ctx.body = `data loaded length: ${data.length}`;
    
    // 清除局部引用
    data = null;
    // 删除模块缓存
    delete require.cache[modulePath];
    // 手动触发GC（需启动参数--expose-gc）
    if (global.gc) global.gc();
    
    return;
  }

  if (ctx.request.href.includes('module2')){
    const modulePath = require.resolve('./large-module2');
    let data = require(modulePath);
    console.log(V8.getHeapStatistics());
    ctx.body = `data loaded length: ${data.length}`;
    
    data = null;
    delete require.cache[modulePath];
    if (global.gc) global.gc();
  }
});

app.listen(3000);

注意：若模块内部存在global变量、定时器、事件监听，必须先手动清理这些资源（比如清除定时器、删除全局变量），否则GC无法回收。

2. 使用Worker线程隔离模块（可靠场景） #

如果模块存在复杂引用或资源无法手动清理，Worker线程是最可靠的方案。Worker拥有独立内存空间，销毁后其占用内存会被系统完全释放，不影响主进程。

主进程代码：

const Koa = require('koa');
const V8 = require('v8');
const { Worker } = require('worker_threads');
const app = new Koa();

// 封装Worker加载模块的函数
const loadModuleInWorker = async (modulePath) => {
  return new Promise((resolve, reject) => {
    const worker = new Worker('./module-loader-worker.js', {
      workerData: { modulePath }
    });
    worker.on('message', resolve);
    worker.on('error', reject);
    worker.on('exit', code => {
      if (code !== 0) reject(new Error(`Worker exited with code ${code}`));
    });
  });
};

app.use(async ctx => {
  if (ctx.request.href.includes('module1')){
    const result = await loadModuleInWorker('./large-module');
    console.log(V8.getHeapStatistics());
    ctx.body = `data loaded length: ${result.length}`;
    return;
  }

  if (ctx.request.href.includes('module2')){
    const result = await loadModuleInWorker('./large-module2');
    console.log(V8.getHeapStatistics());
    ctx.body = `data loaded length: ${result.length}`;
  }
});

app.listen(3000);

Worker线程代码（module-loader-worker.js）：

const { workerData, parentPort } = require('worker_threads');
// 在Worker中加载模块
const data = require(workerData.modulePath);
// 发送结果给主进程
parentPort.postMessage({ length: data.length });
// 主动退出Worker，释放内存
process.exit();

3. 改用ES模块动态导入（可选） #

ES模块的import()异步加载，缓存机制与CommonJS不同，适合已使用ES模块的项目（Node.js 16+支持）：

// 需将文件改为.mjs或在package.json中设置"type": "module"
import Koa from 'koa';
import V8 from 'v8';

const app = new Koa();

app.use(async ctx => {
  if (ctx.request.href.includes('module1')){
    const modulePath = new URL('./large-module.mjs', import.meta.url).href;
    const { default: data } = await import(modulePath);
    console.log(V8.getHeapStatistics());
    ctx.body = `data loaded length: ${data.length}`;
    
    // 清除ES模块缓存
    delete globalThis.require.cache[modulePath];
    if (global.gc) global.gc();
    return;
  }
});

关键注意事项 #

• 关注正确的内存指标：优先看used_heap_size而非total_heap_size，后者是V8预分配空间，GC后不会立即收缩。
• 避免模块残留引用：模块内部不要使用全局变量、持久化定时器/事件监听器，必须使用时要提供销毁接口。
• 手动GC仅作调试：生产环境不要依赖global.gc()，GC触发应由V8自动管理。

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