首页 > 文章 > 前端

Node.js大文件流处理技巧分享

时间：2026-01-14 08:28:33 388浏览收藏

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《Node.js流处理大文件上传下载技巧》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

使用流处理大文件可避免内存溢出。1. 上传时用multer分块暂存，再通过fs.createReadStream读取并pipe到目标文件，最后删除临时文件；2. 下载时用fs.createReadStream创建读取流，设置响应头后pipe到res，实现分批传输；3. 增强稳定性需监听error事件，及时销毁流并释放资源。

如何用Node.js流处理大文件上传与下载？

处理大文件上传与下载时，直接读取整个文件到内存会导致内存溢出。Node.js 的流（Stream）机制能有效解决这个问题，通过分块传输数据，实现高效、低内存占用的文件操作。

使用流处理大文件上传

前端上传大文件时，后端应避免一次性加载整个文件。利用 multer 中间件配合流式写入，可将文件分块保存到磁盘。

安装 multer：

npm install multer

示例代码：

说明：multer 将文件暂存本地，再通过可读流读取并用 pipe 导入可写流，逐块写入目标位置，避免内存压力。

使用流处理大文件下载

用户请求下载大文件时，不应使用 fs.readFile，而应创建可读流，通过 pipe 发送给响应对象。

示例代码：

app.get('/download/:filename', (req, res) => {
  const filename = req.params.filename;
  const filePath = `./files/${filename}`;

  fs.access(filePath, fs.constants.F_OK, (err) => {
    if (err) return res.status(404).send('文件不存在');

    const readStream = fs.createReadStream(filePath);
    res.setHeader('Content-Disposition', `attachment; filename="${filename}"`);
    res.setHeader('Content-Type', 'application/octet-stream');

    readStream.pipe(res);
  });
});

说明：设置合适的响应头后，将文件流通过 pipe 接入 HTTP 响应，数据分批发送，不占内存。

提升流处理稳定性

在实际应用中，需考虑错误处理和资源释放，确保服务健壮。

监听流的 error 事件，防止崩溃
下载失败时及时销毁流
上传完成后清理临时文件

增强版下载示例：

readStream.on('error', (err) => {
  console.error('读取失败:', err);
  res.status(500).send('下载失败');
});
res.on('close', () => {
  readStream.destroy();
});

基本上就这些。用流处理大文件，核心是避免内存堆积，借助 pipe 实现高效管道传输，上传下载都能稳定运行。

好了，本文到此结束，带大家了解了《Node.js大文件流处理技巧分享》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！

前往漫画官网入口并下载 ➜