本文详解如何正确分块生成并传输大型 excel 文件，解决因重复创建同名 sheet 或流提前关闭导致的数据截断问题，提供基于 apache poi 的内存优化方案及二进制分块收发完整示例。
本文详解如何正确分块生成并传输大型 excel 文件，解决因重复创建同名 sheet 或流提前关闭导致的数据截断问题，提供基于 apache poi 的内存优化方案及二进制分块收发完整示例。
在 Web 服务或微服务架构中，向客户端流式传输大型 Excel 文件（如含上万行数据）时，若直接使用 SXSSFWorkbook 分批写入同一 ServletOutputStream，极易陷入逻辑陷阱：每次调用 workbook.write(outputStream) 后再尝试新建同名 Sheet，会触发 IllegalArgumentException: The workbook already contains a sheet of this name；而若复用原 Sheet 并清空行，则因 SXSSFWorkbook 的底层流机制限制，多次 write() 调用会导致后续写入静默失败或文件结构损坏——这正是原始代码仅输出 100 行的根本原因。
根本症结在于：Excel 是结构化二进制/ZIP 容器格式，不支持“追加写入”单个 Sheet。Workbook.write(OutputStream) 总是输出完整、自洽的 .xlsx 文件（含 [Content_Types].xml、xl/workbook.xml、xl/worksheets/sheet1.xml 等完整部件），而非增量数据块。因此，试图“分批写入同一输出流”本质上违背了 Office Open XML 规范。
✅ 正确解法分两类，按场景选择：
方案一：服务端内存优化 + 单次完整输出（推荐用于 Web API）
避免分块写流，改用 SXSSFWorkbook 的滚动窗口机制，在内存可控前提下一次性生成完整文件，再整体写出：
@Override
public void generateAndSendExcel(ServletOutputStream outputStream) throws IOException {
// 每次只保留在内存中的 1000 行，超出部分刷入临时磁盘（自动管理）
SXSSFWorkbook workbook = new SXSSFWorkbook(1000);
Sheet sheet = workbook.createSheet("Datos");
int totalRows = 10000;
for (int i = 0; i < totalRows; i++) {
Row row = sheet.createRow(i);
Cell cell = row.createCell(0);
cell.setCellValue("Valor " + (i + 1));
}
// 一次性写出完整、有效的 .xlsx 文件
workbook.write(outputStream);
outputStream.flush();
// 清理临时文件（SXSSF 必须调用）
workbook.dispose();
}✅ 优势：客户端收到标准 Excel 文件，无需额外拼接；内存占用可控（由 SXSSFWorkbook(int windowSize) 控制）。
⚠️ 注意：确保 workbook.dispose() 被调用，否则临时文件残留。
方案二：二进制分块传输（适用于断点续传、分布式生成等特殊场景）
当必须分块网络传输时，应操作 Excel 文件的最终二进制字节流，而非中间对象。流程为：
- 服务端：生成完整 Excel → 读取为 byte[] → 按固定大小切分为 .bin 块 → 分别发送（附序号）；
- 客户端：接收所有块 → 按序号合并为完整 byte[] → 写入 .xlsx 文件。
参考实现（精简健壮版）：
// 【发送端】将 Excel 文件切分为有序二进制块
public static List<byte[]> splitExcelToBlocks(File excelFile, int blockSize) throws IOException {
try (FileInputStream fis = new FileInputStream(excelFile)) {
byte[] fullBytes = fis.readAllBytes();
List<byte[]> blocks = new ArrayList<>();
for (int i = 0; i < fullBytes.length; i += blockSize) {
int len = Math.min(blockSize, fullBytes.length - i);
byte[] block = new byte[len];
System.arraycopy(fullBytes, i, block, 0, len);
blocks.add(block);
}
return blocks; // 返回块列表，按索引顺序
}
}
// 【接收端】按序合并二进制块为完整 Excel
public static void mergeBlocksToFile(List<byte[]> blocks, File outputFile) throws IOException {
try (FileOutputStream fos = new FileOutputStream(outputFile)) {
for (byte[] block : blocks) {
fos.write(block);
}
}
}✅ 关键原则：分块操作对象是 byte[]，完全绕过 POI 对象模型，规避所有 Sheet 名称、流状态冲突。
⚠️ 注意：块命名需包含序号（如 report_000.bin, report_001.bin），确保接收方可严格排序；建议增加 SHA-256 校验和验证完整性。
总结：Excel 分块传输不是“分批写 Sheet”，而是“分块传文件”。日常 Web 导出首选 SXSSFWorkbook 单次生成；仅当网络不可靠或需协同处理时，才采用二进制切片方案。二者均能彻底规避原始代码中 createSheet("Datos") 冲突与流失效问题，保障数据完整性与格式合规性。
