在 Node.js 里处理文件上传，很多人一开始会用 `multer` 的默认配置或者 `formidable` 把文件先收进内存，再统一写盘。小文件没问题，但一旦用户传的是几十兆的图片、视频或者压缩包，进程内存就会迅速上涨，甚至触发 OOM 重启。更隐蔽的情况是并发上传，几个请求同时把文件缓存在内存里，内存曲线会像锯齿一样反复冲高。这个问题在管理后台、文件服务、导入功能里很常见，根源在于中间件默认把上传流聚合成了 Buffer 或临时对象，而不是边读边写。下面从实际代码出发，梳理如何用流式方式接管上传，控制内存占用，并处理写盘失败、临时文件清理和并发场景下的边界情况。

先看一个常见的错误写法。用 `multer` 的 memoryStorage 接收文件，然后在路由里再写盘：

```js
const multer = require('multer');
const upload = multer({ storage: multer.memoryStorage() });

app.post('/upload', upload.single('file'), async (req, res) => {
 await fs.promises.writeFile(`/data/${req.file.originalname}`, req.file.buffer);
 res.json({ ok: true });
});
```

这段代码的问题很明显：`req.file.buffer` 是整个文件的内容，文件多大内存就占多大。并发 10 个 50MB 的文件，就是 500MB 的 Buffer 常驻，加上 V8 堆外内存，容器很容易被撑爆。

换成 `diskStorage` 能缓解这个问题，因为 multer 会把文件直接写到临时目录。但 `diskStorage` 本身也有细节要注意，比如 `destination` 和 `filename` 的调用时机，以及写盘失败时 multer 是否会自动清理。下面是一个更可控的写法：

```js
const path = require('path');
const crypto = require('crypto');
const multer = require('multer');

const storage = multer.diskStorage({
 destination(req, file, cb) {
 cb(null, '/data/tmp');
 },
 filename(req, file, cb) {
 const ext = path.extname(file.originalname);
 const name = crypto.randomBytes(16).toString('hex') + ext;
 cb(null, name);
 }
});

const upload = multer({
 storage,
 limits: { fileSize: 200 * 1024 * 1024 }
});
```

这里用随机文件名而不是原始文件名，避免路径穿越和重名覆盖。`limits.fileSize` 限制单文件大小，超过限制 multer 会中断流并报错。但 multer 在超限时是否删除已经写入的部分文件，取决于版本和错误处理方式，所以更稳妥的做法是在错误中间件里检查临时文件并清理。

如果不想依赖 multer 的临时文件机制，可以直接用 `busboy` 或 `formidable` 的流接口，自己控制写盘。以 `busboy` 为例：

```js
const Busboy = require('busboy');
const fs = require('fs');
const path = require('path');
const crypto = require('crypto');

app.post('/upload', (req, res) => {
 const busboy = Busboy({ headers: req.headers, limits: { fileSize: 200 * 1024 * 1024 } });
 const writes = [];
 let filePath = null;

 busboy.on('file', (name, file, info) => {
 const ext = path.extname(info.filename);
 const tmpName = crypto.randomBytes(16).toString('hex') + ext;
 filePath = path.join('/data/tmp', tmpName);
 const ws = fs.createWriteStream(filePath);

 file.on('limit', () => {
 ws.destroy();
 fs.unlink(filePath, () => {});
 });

 file.pipe(ws);
 writes.push(new Promise((resolve, reject) => {
 ws.on('finish', resolve);
 ws.on('error', reject);
 file.on('error', reject);
 }));
 });

 busboy.on('finish', async () => {
 try {
 await Promise.all(writes);
 res.json({ ok: true, path: filePath });
 } catch (err) {
 if (filePath) fs.unlink(filePath, () => {});
 res.status(500).json({ error: 'write failed' });
 }
 });

 req.pipe(busboy);
});
```

这段代码里，`file` 是一个可读流，直接 `pipe` 到写流，内存里不会保留完整文件内容。`limit` 事件触发时销毁写流并删除半截文件，避免留下垃圾。所有写流用 Promise 收集，等 `finish` 后统一等待，确保响应时文件已经落盘。

流式写盘还要注意错误传播。如果磁盘满了，写流会触发 `error`，这时候需要中止请求并清理。`pipe` 默认不会自动销毁源流，所以最好用 `pipeline` 代替 `pipe`：

```js
const { pipeline } = require('stream/promises');

busboy.on('file', (name, file, info) => {
 const ws = fs.createWriteStream(filePath);
 writes.push(pipeline(file, ws));
});
```

`pipeline` 会在任意一端出错时销毁所有流，并把错误抛给 Promise，处理起来更干净。

并发场景下，临时目录的清理策略也要考虑。可以在启动时扫一遍 `/data/tmp`，删除超过一定时间的文件；或者在写盘成功后立即移到正式目录，临时目录只作为中转。移动用 `fs.rename`，同一文件系统内是原子操作，比复制再删除更安全。

最后提一个容易被忽略的点：请求体过大时，Node.js 的 HTTP 解析器会先收到数据再交给业务流，如果客户端传得很快而磁盘写得慢，背压会让 `req` 暂停，这是流机制在起作用。但如果用了 `req.pipe(busboy)` 而 busboy 内部没有正确暂停，可能出现内存堆积。实际测试时可以用 `curl` 传一个大文件，同时用 `process.memoryUsage()` 打日志观察 RSS 变化，确认内存保持平稳而不是随文件大小线性增长。

 推荐查看笑话：https://www.tianqi323.com/joke/7038.html
 推荐查看笑话：https://www.tianqi323.com/joke/7039.html
 推荐查看笑话：https://www.tianqi323.com/joke/7040.html
 推荐查看笑话：https://www.tianqi323.com/joke/7041.html
 推荐查看笑话：https://www.tianqi323.com/joke/7042.html
 推荐查看笑话：https://www.tianqi323.com/joke/7043.html
 推荐查看笑话：https://www.tianqi323.com/joke/7044.html
 推荐查看笑话：https://www.tianqi323.com/joke/7045.html
 推荐查看笑话：https://www.tianqi323.com/joke/7046.html
 推荐查看笑话：https://www.tianqi323.com/joke/7047.html
 推荐查看笑话：https://www.tianqi323.com/joke/7048.html
 推荐查看笑话：https://www.tianqi323.com/joke/7049.html
 推荐查看笑话：https://www.tianqi323.com/joke/7050.html
 推荐查看笑话：https://www.tianqi323.com/joke/7051.html
 推荐查看笑话：https://www.tianqi323.com/joke/7052.html
 推荐查看笑话：https://www.tianqi323.com/joke/7053.html
 推荐查看笑话：https://www.tianqi323.com/joke/7054.html
 推荐查看笑话：https://www.tianqi323.com/joke/7055.html
 推荐查看笑话：https://www.tianqi323.com/joke/7056.html
 推荐查看笑话：https://www.tianqi323.com/joke/7057.html
 推荐查看笑话：https://www.tianqi323.com/joke/7058.html
 推荐查看笑话：https://www.tianqi323.com/joke/7059.html
 推荐查看笑话：https://www.tianqi323.com/joke/7060.html
 推荐查看笑话：https://www.tianqi323.com/joke/7061.html
 推荐查看笑话：https://www.tianqi323.com/joke/7062.html
 推荐查看笑话：https://www.tianqi323.com/joke/7063.html
 推荐查看笑话：https://www.tianqi323.com/joke/7064.html
 推荐查看笑话：https://www.tianqi323.com/joke/7065.html
 推荐查看笑话：https://www.tianqi323.com/joke/7066.html
 推荐查看笑话：https://www.tianqi323.com/joke/7067.html
 推荐查看笑话：https://www.tianqi323.com/joke/7068.html
 推荐查看笑话：https://www.tianqi323.com/joke/7069.html
 推荐查看笑话：https://www.tianqi323.com/joke/7070.html
 推荐查看笑话：https://www.tianqi323.com/joke/7071.html
 推荐查看笑话：https://www.tianqi323.com/joke/7072.html
 推荐查看笑话：https://www.tianqi323.com/joke/7073.html
 推荐查看笑话：https://www.tianqi323.com/joke/7074.html
 推荐查看笑话：https://www.tianqi323.com/joke/7075.html
 推荐查看笑话：https://www.tianqi323.com/joke/7076.html
 推荐查看笑话：https://www.tianqi323.com/joke/7077.html
 推荐查看笑话：https://www.tianqi323.com/joke/7078.html
 推荐查看笑话：https://www.tianqi323.com/joke/7079.html
 推荐查看笑话：https://www.tianqi323.com/joke/7080.html
 推荐查看笑话：https://www.tianqi323.com/joke/7081.html
 推荐查看笑话：https://www.tianqi323.com/joke/7082.html
 推荐查看笑话：https://www.tianqi323.com/joke/7083.html
 推荐查看笑话：https://www.tianqi323.com/joke/7084.html
 推荐查看笑话：https://www.tianqi323.com/joke/7085.html
 推荐查看笑话：https://www.tianqi323.com/joke/7086.html
 推荐查看笑话：https://www.tianqi323.com/joke/7087.html
 推荐查看笑话：https://www.tianqi323.com/joke/7088.html
 推荐查看笑话：https://www.tianqi323.com/joke/7089.html
 推荐查看笑话：https://www.tianqi323.com/joke/7090.html
 推荐查看笑话：https://www.tianqi323.com/joke/7091.html
 推荐查看笑话：https://www.tianqi323.com/joke/7092.html
 推荐查看笑话：https://www.tianqi323.com/joke/7093.html
 推荐查看笑话：https://www.tianqi323.com/joke/7094.html
 推荐查看笑话：https://www.tianqi323.com/joke/7095.html
 推荐查看笑话：https://www.tianqi323.com/joke/7096.html
 推荐查看笑话：https://www.tianqi323.com/joke/7097.html
 推荐查看笑话：https://www.tianqi323.com/joke/7098.html
 推荐查看笑话：https://www.tianqi323.com/joke/7099.html
 推荐查看笑话：https://www.tianqi323.com/joke/7100.html
 推荐查看笑话：https://www.tianqi323.com/joke/7101.html
 推荐查看笑话：https://www.tianqi323.com/joke/7102.html
 推荐查看笑话：https://www.tianqi323.com/joke/7103.html
 推荐查看笑话：https://www.tianqi323.com/joke/7104.html
 推荐查看笑话：https://www.tianqi323.com/joke/7105.html
 推荐查看笑话：https://www.tianqi323.com/joke/7106.html
 推荐查看笑话：https://www.tianqi323.com/joke/7107.html
 推荐查看笑话：https://www.tianqi323.com/joke/7108.html
 推荐查看笑话：https://www.tianqi323.com/joke/7109.html
 推荐查看笑话：https://www.tianqi323.com/joke/7110.html
 推荐查看笑话：https://www.tianqi323.com/joke/7111.html
 推荐查看笑话：https://www.tianqi323.com/joke/7112.html
 推荐查看笑话：https://www.tianqi323.com/joke/7113.html
 推荐查看笑话：https://www.tianqi323.com/joke/7114.html
 推荐查看笑话：https://www.tianqi323.com/joke/7115.html
 推荐查看笑话：https://www.tianqi323.com/joke/7116.html
 推荐查看笑话：https://www.tianqi323.com/joke/7117.html
 推荐查看笑话：https://www.tianqi323.com/joke/7118.html
 推荐查看笑话：https://www.tianqi323.com/joke/7119.html
 推荐查看笑话：https://www.tianqi323.com/joke/7120.html
 推荐查看笑话：https://www.tianqi323.com/joke/7121.html
 推荐查看笑话：https://www.tianqi323.com/joke/7122.html
 推荐查看笑话：https://www.tianqi323.com/joke/7123.html
 推荐查看笑话：https://www.tianqi323.com/joke/7124.html
 推荐查看笑话：https://www.tianqi323.com/joke/7125.html
 推荐查看笑话：https://www.tianqi323.com/joke/7126.html
 推荐查看笑话：https://www.tianqi323.com/joke/7127.html
 推荐查看笑话：https://www.tianqi323.com/joke/7128.html
 推荐查看笑话：https://www.tianqi323.com/joke/7129.html
 推荐查看笑话：https://www.tianqi323.com/joke/7130.html
 推荐查看笑话：https://www.tianqi323.com/joke/7131.html
 推荐查看笑话：https://www.tianqi323.com/joke/7132.html
 推荐查看笑话：https://www.tianqi323.com/joke/7133.html
 推荐查看笑话：https://www.tianqi323.com/joke/7134.html
 推荐查看笑话：https://www.tianqi323.com/joke/7135.html
 推荐查看笑话：https://www.tianqi323.com/joke/7136.html
 推荐查看笑话：https://www.tianqi323.com/joke/7137.html
 推荐查看笑话：https://www.tianqi323.com/joke/7138.html
 推荐查看笑话：https://www.tianqi323.com/joke/7139.html
 推荐查看笑话：https://www.tianqi323.com/joke/7140.html
 推荐查看笑话：https://www.tianqi323.com/joke/7141.html
 推荐查看笑话：https://www.tianqi323.com/joke/7142.html
 推荐查看笑话：https://www.tianqi323.com/joke/7143.html
 推荐查看笑话：https://www.tianqi323.com/joke/7144.html
 推荐查看笑话：https://www.tianqi323.com/joke/7145.html
 推荐查看笑话：https://www.tianqi323.com/joke/7146.html
 推荐查看笑话：https://www.tianqi323.com/joke/7147.html
 推荐查看笑话：https://www.tianqi323.com/joke/7148.html
 推荐查看笑话：https://www.tianqi323.com/joke/7149.html
 推荐查看笑话：https://www.tianqi323.com/joke/7150.html
 推荐查看笑话：https://www.tianqi323.com/joke/7151.html
 推荐查看笑话：https://www.tianqi323.com/joke/7152.html
 推荐查看笑话：https://www.tianqi323.com/joke/7153.html
 推荐查看笑话：https://www.tianqi323.com/joke/7154.html
 推荐查看笑话：https://www.tianqi323.com/joke/7155.html
 推荐查看笑话：https://www.tianqi323.com/joke/7156.html
 推荐查看笑话：https://www.tianqi323.com/joke/7157.html
 推荐查看笑话：https://www.tianqi323.com/joke/7158.html
 推荐查看笑话：https://www.tianqi323.com/joke/7159.html
 推荐查看笑话：https://www.tianqi323.com/joke/7160.html
 推荐查看笑话：https://www.tianqi323.com/joke/7161.html
 推荐查看笑话：https://www.tianqi323.com/joke/7162.html
 推荐查看笑话：https://www.tianqi323.com/joke/7163.html
 推荐查看笑话：https://www.tianqi323.com/joke/7164.html
 推荐查看笑话：https://www.tianqi323.com/joke/7165.html
 推荐查看笑话：https://www.tianqi323.com/joke/7166.html
 推荐查看笑话：https://www.tianqi323.com/joke/7167.html
 推荐查看笑话：https://www.tianqi323.com/joke/7168.html
 推荐查看笑话：https://www.tianqi323.com/joke/7169.html
 推荐查看笑话：https://www.tianqi323.com/joke/7170.html
 推荐查看笑话：https://www.tianqi323.com/joke/7171.html
 推荐查看笑话：https://www.tianqi323.com/joke/7172.html
 推荐查看笑话：https://www.tianqi323.com/joke/7173.html
 推荐查看笑话：https://www.tianqi323.com/joke/7174.html
 推荐查看笑话：https://www.tianqi323.com/joke/7175.html
 推荐查看笑话：https://www.tianqi323.com/joke/7176.html
 推荐查看笑话：https://www.tianqi323.com/joke/7177.html
 推荐查看笑话：https://www.tianqi323.com/joke/7178.html
 推荐查看笑话：https://www.tianqi323.com/joke/7179.html
 推荐查看笑话：https://www.tianqi323.com/joke/7180.html
 推荐查看笑话：https://www.tianqi323.com/joke/7181.html
 推荐查看笑话：https://www.tianqi323.com/joke/7182.html
 推荐查看笑话：https://www.tianqi323.com/joke/7183.html
 推荐查看笑话：https://www.tianqi323.com/joke/7184.html
 推荐查看笑话：https://www.tianqi323.com/joke/7185.html
 推荐查看笑话：https://www.tianqi323.com/joke/7186.html
 推荐查看笑话：https://www.tianqi323.com/joke/7187.html
 推荐查看笑话：https://www.tianqi323.com/joke/7188.html
 推荐查看笑话：https://www.tianqi323.com/joke/7189.html
 推荐查看笑话：https://www.tianqi323.com/joke/7190.html
 推荐查看笑话：https://www.tianqi323.com/joke/7191.html
 推荐查看笑话：https://www.tianqi323.com/joke/7192.html
 推荐查看笑话：https://www.tianqi323.com/joke/7193.html
 推荐查看笑话：https://www.tianqi323.com/joke/7194.html
 推荐查看笑话：https://www.tianqi323.com/joke/7195.html
 推荐查看笑话：https://www.tianqi323.com/joke/7196.html
 推荐查看笑话：https://www.tianqi323.com/joke/7197.html
 推荐查看笑话：https://www.tianqi323.com/joke/7198.html
 推荐查看笑话：https://www.tianqi323.com/joke/7199.html
 推荐查看笑话：https://www.tianqi323.com/joke/7200.html
 推荐查看笑话：https://www.tianqi323.com/joke/7201.html
 推荐查看笑话：https://www.tianqi323.com/joke/7202.html
 推荐查看笑话：https://www.tianqi323.com/joke/7203.html
 推荐查看笑话：https://www.tianqi323.com/joke/7204.html
 推荐查看笑话：https://www.tianqi323.com/joke/7205.html
 推荐查看笑话：https://www.tianqi323.com/joke/7206.html
 推荐查看笑话：https://www.tianqi323.com/joke/7207.html
 推荐查看笑话：https://www.tianqi323.com/joke/7208.html
 推荐查看笑话：https://www.tianqi323.com/joke/7209.html
 推荐查看笑话：https://www.tianqi323.com/joke/7210.html
 推荐查看笑话：https://www.tianqi323.com/joke/7211.html
 推荐查看笑话：https://www.tianqi323.com/joke/7212.html
 推荐查看笑话：https://www.tianqi323.com/joke/7213.html
 推荐查看笑话：https://www.tianqi323.com/joke/7214.html
 推荐查看笑话：https://www.tianqi323.com/joke/7215.html
 推荐查看笑话：https://www.tianqi323.com/joke/7216.html
 推荐查看笑话：https://www.tianqi323.com/joke/7217.html
 推荐查看笑话：https://www.tianqi323.com/joke/7218.html
 推荐查看笑话：https://www.tianqi323.com/joke/7219.html
 推荐查看笑话：https://www.tianqi323.com/joke/7220.html
 推荐查看笑话：https://www.tianqi323.com/joke/7221.html
 推荐查看笑话：https://www.tianqi323.com/joke/7222.html
 推荐查看笑话：https://www.tianqi323.com/joke/7223.html
 推荐查看笑话：https://www.tianqi323.com/joke/7224.html
 推荐查看笑话：https://www.tianqi323.com/joke/7225.html
 推荐查看笑话：https://www.tianqi323.com/joke/7226.html
 推荐查看笑话：https://www.tianqi323.com/joke/7227.html
 推荐查看笑话：https://www.tianqi323.com/joke/7228.html
 推荐查看笑话：https://www.tianqi323.com/joke/7229.html
 推荐查看笑话：https://www.tianqi323.com/joke/7230.html
 推荐查看笑话：https://www.tianqi323.com/joke/7231.html
 推荐查看笑话：https://www.tianqi323.com/joke/7232.html
 推荐查看笑话：https://www.tianqi323.com/joke/7233.html
 推荐查看笑话：https://www.tianqi323.com/joke/7234.html
 推荐查看笑话：https://www.tianqi323.com/joke/7235.html
 推荐查看笑话：https://www.tianqi323.com/joke/7236.html
 推荐查看笑话：https://www.tianqi323.com/joke/7237.html

在 Node.js 里处理文件上传，很多人一开始会用 multer 的默认配置或者 formidable 把文件先收进内存，再统一写盘。小文件没问题，但一旦用户传的是几十兆的图片、视频或者压缩包，进程内存就会迅速上涨，甚至触发 OOM 重启。更隐蔽的情况是并发上传，几个请求同时把文件缓存在内存里，内存曲线会像锯齿一样反复冲高。这个问题在管理后台、文件服务、导入功能里很常见，根源在于中间件默认把上传流聚合成了 Buffer 或临时对象，而不是边读边写。下面从实际代码出发，梳理如何用流式方式接管上传，控制内存占用，并处理写盘失败、临时文件清理和并发场景下的边界情况。

Node.js 中处理文件上传时如何避免内存暴涨：流式写盘的实践

在 Node.js 里处理文件上传，很多人一开始会用 multer 的默认配置或者 formidable 把文件先收进内存，再统一写盘。小文件没问题，但一旦用户传的是几十兆的图片、视频或者压缩包，进程内存就会迅速上涨，甚至触发 OOM 重启。更隐蔽的情况是并发上传，几个请求同时把文件缓存在内存里，内存曲线会像锯齿一样反复冲高。这个问题在管理后台、文件服务、导入功能里很常见，根源在于中间件默认把上传

编程语言

后端

开发工具

Node.js大文件上传易致内存溢出，本文详解流式处理方案。对比multer memoryStorage与diskStorage缺陷，演示busboy流接口边读边写，结合pipeline管理错误与临时文件清理，实现内存平稳、高效可靠的上传服务。

文件系统

代码解释

中间件

容器

路由

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Node.js 中处理文件上传时如何避免内存暴涨：流式写盘的实践-腾讯云开发者社区-腾讯云

Node.js 中处理文件上传时如何避免内存暴涨：流式写盘的实践

Node.js 中处理文件上传时如何避免内存暴涨：流式写盘的实践

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐