为何Multer处理文件请求后未释放内存？

在开发Node.js文件上传应用时，遇到以下问题：使用Multer的memoryStorage接收200KB的文件请求时，内存占用会达到400KB，且请求结束后内存不会立即释放，直到应用接收新请求并重复该行为。

复现代码 #

const multer = require("multer");
const storage = multer.memoryStorage();
const upload = multer({
  storage: storage
});


const app = express();
const port = process.env.PORT || 3002;

app.use(express.json());

app.post("/submitRequest", upload.single("file"), async (req, res) => {
  return res.send('ok')
});


const server = app.listen(port, () => {
  console.log(`Server is running on https://localhost:${port}`);
});

console.log('Server started at:', new Date().toLocaleString());

问题分析 #

1. 内存开销与Buffer特性：memoryStorage会将文件内容加载到Node.js的Buffer中，而Buffer的内存分配存在对齐机制，实际占用内存可能会大于文件原始大小（比如200KB文件占用400KB内存），这是Node.js底层内存管理的正常现象。
2. 垃圾回收延迟：请求结束后内存未立即释放并非泄漏，而是Node.js的垃圾回收（GC）机制不会实时触发。只有当堆内存达到回收阈值，或系统空闲时，GC才会清理不再被引用的对象（比如存储文件的Buffer）。
3. 中间对象残留：Multer处理请求过程中会创建一些临时对象，这些对象的引用需要等待GC周期才能被清除。

解决方案 #

1. 改用磁盘存储（推荐生产环境）

避免将文件加载到内存，直接写入磁盘彻底解决内存占用问题：

const multer = require("multer");
const path = require("path");
// 配置磁盘存储
const storage = multer.diskStorage({
  destination: (req, file, cb) => {
    // 确保uploads目录存在，可提前创建或用mkdirp包自动创建
    cb(null, path.join(__dirname, "uploads"));
  },
  filename: (req, file, cb) => {
    // 生成唯一文件名避免冲突
    cb(null, `${Date.now()}-${file.originalname}`);
  }
});
const upload = multer({ storage: storage });

2. 优化内存存储的内存回收（仅适用于必须用内存存储的场景）

• 手动清除文件引用，帮助GC识别可回收对象：

app.post("/submitRequest", upload.single("file"), async (req, res) => {
  // 处理完文件后主动清除引用
  if (req.file) {
    req.file.buffer = null;
    req.file = null;
  }
  res.send('ok');
});

• 调试时可手动触发GC（生产环境不推荐）：启动Node进程时添加--expose-gc参数，然后在代码中调用global.gc()，但依赖手动GC会影响应用性能，仅用于问题排查。

3. 精确监控内存状态

使用Node.js内置的process.memoryUsage()获取堆内存的详细数据，替代外部工具的瞬时值，避免误判：

setInterval(() => {
  const memUsage = process.memoryUsage();
  console.log(`堆内存使用: ${(memUsage.heapUsed / 1024 / 1024).toFixed(2)} MB`);
}, 1000);

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