ExcelJS的writeBuffer方法内存溢出问题求解决方案

AI 小北

2026-7-7

解决ExcelJS writeBuffer处理大文件内存溢出的方案

1. 改用流式写入替代writeBuffer

writeBuffer会将整个Excel文件加载到内存生成完整Buffer，处理大文件时必然触发内存溢出。换成流式写入直接输出到文件或流，从根源避免内存堆积：

const fs = require('fs');
const stream = fs.createWriteStream('large-file.xlsx');
await workbook.xlsx.write(stream);
stream.end();

如果是HTTP服务场景，直接将流pipe到response对象即可，无需生成完整Buffer。

2. 临时提升Node.js内存限制

如果必须使用writeBuffer，可以尝试扩大Node.js的堆内存上限，启动脚本时添加参数：

node --max-old-space-size=8192 your-script.js

8192代表分配8GB内存，可根据实际需求调整，但这只是临时方案，无法彻底解决大文件内存占用问题。

3. 分批次处理数据

不要一次性将所有数据加载到workbook，分批次写入并复用临时文件：

初始化基础workbook结构，写入第一批数据后保存到临时文件
清空当前workbook内存数据，加载临时文件写入下一批数据
重复上述步骤直至所有数据写入完成

示例代码思路：

const fs = require('fs');
const ExcelJS = require('exceljs');

async function processLargeData(dataChunks) {
  let tempFilePath = 'temp.xlsx';
  for (let i = 0; i < dataChunks.length; i++) {
    const workbook = new ExcelJS.Workbook();
    if (fs.existsSync(tempFilePath)) {
      await workbook.xlsx.readFile(tempFilePath);
    } else {
      workbook.addWorksheet('Sheet1');
    }
    const worksheet = workbook.getWorksheet('Sheet1');
    // 写入当前批次数据
    dataChunks[i].forEach(row => worksheet.addRow(row));
    await workbook.xlsx.writeFile(tempFilePath);
    // 手动释放内存
    workbook.removeWorksheet('Sheet1');
  }
  // 按需将临时文件转换为目标格式
}