流式导出Excel技巧防内存溢出

本文深入解析了百万级Excel报表导出的真正流式解决方案，直击传统方式（如SXSSFWorkbook）内存瓶颈痛点，强调“数据从数据库游标读出、即时转换、直接写入HTTP响应流”的零暂存核心原则；通过EasyExcel无模板纯流式写入、分页查询协同、JDBC流式结果集配置及底层OOXML手动组装等多层优化，实现在100MB以内堆内存稳定导出百万行，同时警示常见伪流式陷阱，为高并发大数据导出场景提供安全、高效、可落地的一站式技术指南。

导出百万级Excel报表时，用传统方式（如Apache POI的SXSSFWorkbook）虽能控制内存，但仍有瓶颈；真正安全高效的做法是采用流式写入（Streaming Write），即边生成数据边写入输出流，不将整个工作簿加载进内存。

用EasyExcel实现真正的流式导出

EasyExcel是基于POI封装的轻量库，支持“无模板、无缓存、纯流式”写入，适合超大数据量场景：

• 不创建Workbook对象在内存中，而是直接向OutputStream写入二进制Excel流（.xlsx格式）
• 通过WriteSheet和WriteTable配合分批写入，每批可设为5000–10000行，避免单次处理过大
• 使用SimpleWriterBuilder或ExcelWriter配合ServletOutputStream，直接响应HTTP下载

示例关键代码：

response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setHeader("Content-Disposition", "attachment;filename=report.xlsx");
try (ExcelWriter writer = EasyExcel.write(response.getOutputStream()).build()) {
    WriteSheet sheet = EasyExcel.writerSheet("数据").build();
    // 分页查询数据库，每次查1万条，写入一次
    int offset = 0;
    int pageSize = 10000;
    while (true) {
        List data = reportService.listByPage(offset, pageSize);
        if (data.isEmpty()) break;
        writer.write(data, sheet);
        offset += pageSize;
    }
}

手动控制流+自定义SAX写入（进阶可控方案）

若EasyExcel无法满足定制需求（如多表头、复杂样式、跨行合并等），可用POI底层的SXSSFSheet + 自定义OutputStream包装器，或更底层的StreamingWriter（需自行拼接OOXML结构）：

• 禁用自动flush，手动调用sheet.flushRows(1000)释放内存行缓存
• 用ZipOutputStream直接写入xl/worksheets/sheet1.xml等核心部件（需熟悉Excel OOXML规范）
• 推荐结合Apache POI 5.2+中的StreamingWorkbook（实验性API），它提供writeTo(OutputStream)且不持有完整DOM

数据库与IO协同优化（防卡死）

光靠写入优化不够，源头和管道必须匹配：

• 数据库查询用游标式分页（如MySQL LIMIT offset, size + 合理索引；PostgreSQL用cursor-based pagination避免深分页）
• 禁用JDBC的fetchSize = Integer.MIN_VALUE（启用流式结果集），防止驱动一次性拉取全部结果
• 后端响应设置超时时间（如Spring Boot中server.tomcat.connection-timeout=3600），并开启异步导出+进度回调（避免用户长时间等待）

避坑提醒：哪些“看似流式”实则危险

以下做法仍可能导致OOM，务必避开：

• 用XSSFWorkbook或未配置rowAccessWindowSize的SXSSFWorkbook——整表仍在内存中
• 先收集所有数据到List