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 每设一个单元格值都会做校验和缓存更新。大数据量下开销明显。
立即学习“Java免费学习笔记(深入)”;
- 关闭 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 写得重。










