EasyExcel是阿里巴巴开源的基于POI封装的轻量级Excel处理工具,采用SAX模式逐行读写,解决POI内存占用高、大文件OOM问题,适合百万级数据导入导出。

EasyExcel 是什么,为什么选它做海量数据处理
EasyExcel 是阿里巴巴开源的 Excel 处理工具,基于 POI 封装,但解决了 POI 内存占用高、大文件容易 OOM 的问题。它采用“SAX 模式”逐行读写,不把整个 Excel 加载进内存,因此特别适合百万级数据的导入导出。Spring Boot 项目整合 EasyExcel,核心是解决依赖引入、读写逻辑解耦、异步处理和错误容错。
导入:用监听器 + 异步线程池批量入库
导入不是一次性读完再保存,而是边读边处理,避免内存堆积。关键步骤:
- 定义实体类,用 @ExcelProperty("姓名") 标注字段与表头映射关系
- 继承 AnalysisEventListener
实现自定义监听器,在 invoke() 中缓存数据(比如每 1000 条一批),在 doAfterAllAnalysed() 中刷库或触发异步保存 - Controller 层接收 MultipartFile,用 EasyExcel.read() 启动解析,传入监听器实例
- 数据库写入建议交给 @Async 方法 + 线程池执行,防止阻塞 Web 请求;同时配合事务控制(如分批提交,避免单事务过大)
导出:流式写入 + 分页查询 + 响应头设置
导出同样不能查全量数据再写,而是按需分页拉取、流式写出:
- 使用 ExcelWriter 和 WriteSheet 构建写入对象,指定输出流为 HttpServletResponse.getOutputStream()
- 设置响应头:Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,Content-Disposition: attachment;filename=xxx.xlsx
- 后端分页查询(如 PageHelper 或 MyBatis-Plus 的 IPage),每页 5000~10000 条,循环调用 write() 写入数据列表,不缓存全部结果
- 大数据量可加进度标识(如 Redis 记录已导出行数),前端轮询获取状态
实用增强点:校验、模板、错误反馈、Web 流式响应
真实业务中不能只管跑通,还要稳和好用:
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
- 导入时在 invoke() 中做基础校验(空值、格式、长度),失败记录到 context.exception() 并收集错误行号,最后统一返回错误详情 Excel
- 导出支持模板填充:用 EasyExcel.writeWithTemplate() 基于已有样式 Excel 补充数据,保留表头、合并单元格、颜色等
- 大文件导出建议启用 Spring Boot 的 response.flushBuffer() 或使用 StreamingResponseBody 避免响应体缓冲超限
- 前后端约定接口返回任务 ID,后端用异步任务(如 Spring Task 或 XXL-JOB)执行导出,完成后通知前端下载链接
依赖和配置要点
Maven 引入(推荐 3.x 版本):
无需额外配置,但注意 Spring Boot 3.x 需搭配 Jakarta EE 9+,EasyExcel 3.3+ 已适配。若用 Kotlin 或 Lombok,确保 getter/setter 正常生成(@Data 注解没问题)。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










