Node.js多Excel文件合并问题：无法获取合并后附件

1. 先确认响应头配置是否正确 #

服务器返回合并文件时，必须设置正确的响应头，否则客户端无法识别为可下载附件：

• Content-Type 需设为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet（对应xlsx格式）
• Content-Disposition 要明确指定附件类型和文件名
• 大文件场景建议避免硬编码Content-Length，改用流式输出自动处理

示例代码：

// 响应头配置
res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
res.setHeader('Content-Disposition', 'attachment; filename="merged.xlsx"');

2. 大文件必须用流式操作，避免内存溢出 #

4个391MB的文件总容量接近1.5GB，直接加载到内存会导致内存溢出，还可能让响应中断。推荐用exceljs库做流式读写：

const ExcelJS = require('exceljs');

async function mergeFiles(req, res) {
  const outputWorkbook = new ExcelJS.Workbook();
  
  // 逐个处理上传的文件（假设req.files是multer解析后的文件列表）
  for (const file of req.files) {
    const inputWorkbook = new ExcelJS.Workbook();
    // 流式读取本地临时文件
    await inputWorkbook.xlsx.readFile(file.path);
    
    // 复制每个工作表到输出工作簿
    inputWorkbook.worksheets.forEach(ws => {
      const newWs = outputWorkbook.addWorksheet(ws.name);
      // 流式复制行，避免一次性加载所有数据
      ws.eachRow({ includeEmpty: false }, (row) => {
        newWs.addRow(row.values);
      });
    });
  }
  
  // 流式写入响应
  await outputWorkbook.xlsx.write(res);
  res.end();
}

3. 上传环节的配置检查 #

如果用multer处理上传，必须配置磁盘存储（不能用内存存储），同时设置合理的文件大小限制：

const multer = require('multer');
const storage = multer.diskStorage({
  destination: (req, file, cb) => cb(null, './temp_uploads'),
  filename: (req, file, cb) => cb(null, `${Date.now()}_${file.originalname}`)
});
// 单个文件限制420MB，总文件大小按需调整
const upload = multer({ storage, limits: { fileSize: 420 * 1024 * 1024 } });

4. 客户端接收逻辑要适配二进制数据 #

前端请求时必须指定responseType: 'blob'，否则会把二进制文件解析成乱码：

// 前端axios请求示例
axios.post('/merge-excel', formData, {
  responseType: 'blob'
}).then(res => {
  const blobUrl = window.URL.createObjectURL(new Blob([res.data]));
  const downloadLink = document.createElement('a');
  downloadLink.href = blobUrl;
  downloadLink.download = 'merged.xlsx';
  downloadLink.click();
  window.URL.revokeObjectURL(blobUrl);
});

5. 额外排查点 #

• 检查服务器反向代理（如Nginx）的client_max_body_size配置，确保能接收大文件
• 合并过程添加错误捕获，避免静默失败：

try {
  await mergeFiles(req, res);
} catch (err) {
  console.error('合并失败:', err);
  res.status(500).send('文件合并失败，请重试');
}

• 可先在服务器本地生成合并文件，验证文件本身是否正常，排除合并逻辑错误

内容的提问来源于stack exchange，提问作者Pratik Mestry