Java中级项目导出功能推荐EasyExcel:轻量稳定、注解映射、流式写入防OOM;支持动态/多级表头、模板填充、样式定制,并需异步处理下载以提升响应性能。

Java中级项目中实现数据导出功能,核心在于选择轻量、稳定、兼容性好的工具库,并与业务逻辑解耦。Apache POI 和 EasyExcel 是主流方案,但对“JavaExcel”这一名称需明确:它并非官方标准库,可能是对 Java + Excel 组合的泛称,或指代某些封装库(如 jxl 已停更,不推荐);实际开发中应优先选用 EasyExcel(阿里开源,基于 POI 封装,内存友好、API 简洁)或 Apache POI SXSSF(适合大数据量流式写入)。
用 EasyExcel 快速实现导出(推荐用于大多数中级项目)
EasyExcel 隐藏了 POI 的复杂 API,支持注解驱动列映射、自动处理日期/数字格式、内置样式简化、以及分页导出避免 OOM。
- 引入 Maven 依赖(以 Spring Boot 项目为例):
com.alibaba
easyexcel
3.3.2 - 定义导出实体类,用
@ExcelProperty标注字段与表头对应关系:
public class UserExportDTO {
@ExcelProperty("用户编号") private Long id;
@ExcelProperty("姓名") private String name;
@ExcelProperty("注册时间") @DateTimeFormat("yyyy-MM-dd HH:mm") private Date createTime;
} - 在 Controller 中调用导出方法,返回
ResponseEntity或直接写入 HttpServletResponse 输出流,设置 Content-Type 为application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,文件名带.xlsx后缀。
处理动态表头与多级表头
当导出需求涉及可配置列、权限控制列显示,或需要合并单元格的统计报表头(如“订单信息”下分“订单号”“下单时间”“金额”),EasyExcel 提供 WriteSheet 和 HorizontalCellStyleStrategy 支持运行时构建表头。
- 不依赖固定实体类,改用
List构造表头行和数据行,配合- >
EasyExcel.write(...).head(headList).doWrite(dataList)。 - 使用
HeadGenerator或自定义CellWriteHandler实现条件列渲染(例如:管理员看到“手机号”,普通用户看不到)。 - 多级表头通过嵌套 List 实现,第一层是大标题行,第二层是子列行,EasyExcel 自动识别并合并顶层单元格。
大数据量导出防内存溢出(SXSSF / EasyExcel 分片写入)
导出万级以上记录时,全量加载到内存会触发 GC 甚至 OOM。必须采用流式写入策略。
立即学习“Java免费学习笔记(深入)”;
- EasyExcel 默认使用 SXSSF 模式(底层即 POI 的 Streaming API),开启
autoCloseStream = true并设置useDefaultStyle = false可进一步降低开销。 - 结合 MyBatis 的
Cursor或ResultHandler分批查询(如每次查 500 条),边查边写,避免一次性查出全部数据。 - 若用原生 POI,务必使用
SXSSFWorkbook替代XSSFWorkbook,并调用flush()控制临时文件刷盘节奏。
导出结果增强:模板填充与样式定制
纯代码生成易维护,但部分场景需保留固定 Logo、公司抬头、合计行等,此时可用模板方式。
- EasyExcel 支持
writeWithTemplate:准备一个含占位符(如{totalAmount})和基础样式的 Excel 模板,用FillConfig控制重复填充行为。 - 自定义样式:继承
HorizontalCellStyleStrategy,重写createContentCellStyle设置字体、边框、对齐方式;也可用注解@ContentStyle直接标注字段。 - 导出后生成下载链接或发送邮件附件,建议异步处理(如用 Spring @Async 或消息队列),避免阻塞 Web 请求线程。










