Java POI 导出 Excel 卡顿怎么办？优化技巧

Java用POI导出Excel卡顿的核心原因是写法不当导致内存暴涨、GC频繁或IO阻塞，应使用SXSSFWorkbook流式写入、复用样式与字体、关闭自动刷新、优化SQL及分批处理。

Java 用 POI 导出 Excel 卡顿，核心问题往往不是 POI 本身慢，而是写法不当导致内存暴涨、频繁 GC 或 IO 阻塞。关键在避免一次性加载全部数据到内存，改用流式写入 + 合理复用对象。

用 SXSSFWorkbook 替代 XSSFWorkbook

SXSSFWorkbook 是 POI 提供的“低内存”写入器，它背后基于滑动窗口机制，只在内存中保留指定行数（默认100行），超出部分自动刷入临时文件。适合导出万行以上数据。

• 初始化时显式设置 window size，比如 new SXSSFWorkbook(500)，避免默认值太小引发频繁刷盘
• 用完必须调用 sxssfWorkbook.dispose()，否则临时文件不释放，可能占满磁盘
• 不要调用 sxssfWorkbook.write(outputStream) 前反复获取 sheet 或 row——这些操作会触发数据回刷，拖慢速度

避免在循环里重复创建样式和字体

每个 CellStyle 和 Font 对象都占用一定内存，且 POI 内部有样式索引池。循环中每次都 new，不仅慢还会快速耗尽样式槽位（最多64000个）。

• 把常用样式（如标题加粗居中、数字右对齐、日期格式等）提前创建好，复用同一个对象
• 字体建议复用 workbook.getFontAt(0) 或统一创建一个 Font 实例，再绑定到多个 Style
• 如果需动态变色/字号，优先考虑用已有的样式组合，而不是每行都 new 一套

批量写入 + 关闭自动刷新

默认情况下，POI 每设一个单元格值都会做校验和缓存更新。大数据量下开销明显。

• 关闭 sheet 的 autoSizeColumn（如非必要）：sheet.trackAllColumnsForAutoSizing = false
• 写完一整行再 setRowHeight，别每行都调用；写完一批行再 flushRows()，例如每500行执行一次 sxssfWorkbook.flushRows(500)
• 字符串内容尽量用 String 而非 rich text（XSSFRichTextString），后者开销高3–5倍

数据预处理与分批导出

真正卡顿常来自数据库查询或业务逻辑，而非 POI 写入本身。

• 导出前确认 SQL 是否用了 limit + offset 分页，避免全表扫描；加索引覆盖查询字段
• 把耗时计算（

  

  如金额汇总、状态翻译）提到查询层（SQL or MyBatis resultMap），别在 Java 循环里反复 if-else
• 超10万行考虑分 Sheet 或分文件导出，单个文件控制在 5–10 万行内，体验更稳

基本上就这些。不复杂但容易忽略——尤其样式复用和 SXSSF 的 dispose 调用。上线前用 JProfiler 看下内存分配热点，基本能定位到是查库慢、还是 POI 写得重。