Java数据导入导出核心是选库、统模型、处理异常与大文件;常用Apache POI(功能全、适合复杂格式)和EasyExcel(注解驱动、内存友好、适合大数据)。

Java中实现数据导入导出,核心在于选择合适的Excel处理库、统一数据模型、处理异常与大文件场景。常用方案是Apache POI(兼容xls/xlsx)或EasyExcel(更轻量、内存友好),二者都支持注解驱动、模板填充、多Sheet读写。
选型建议:POI vs EasyExcel
Apache POI功能全面,适合复杂格式控制(如合并单元格、样式、公式),但API较底层,需手动处理行列遍历和类型转换;EasyExcel基于POI封装,通过注解自动映射Java对象与列,内置分页读、监听器模式,对百万级数据更友好。
- 小数据量(
- 大数据量、快速开发、关注稳定性 → 优先选EasyExcel
- 已有老系统用xls格式 → POI HSSF仍需支持,但建议逐步迁移xlsx
导入实现关键点
导入本质是“解析Excel → 转为Java对象 → 校验入库”。推荐使用监听器模式(EasyExcel)或迭代器模式(POI),避免一次性加载全量数据到内存。
- 定义DTO类,用@ExcelProperty("姓名")标注字段对应列名(EasyExcel)或按索引取值(POI)
- 校验逻辑放在监听器的invoke()方法中:非空、格式(手机号/邮箱)、业务唯一性(查DB)
- 错误行单独收集,最终返回失败明细(含行号、原因),不因单条失败中断整个导入
- 数据库批量插入用JdbcTemplate.batchUpdate()或MyBatis的
,避免逐条save
导出实现要点
导出重点是结构清晰、性能可控、支持动态列与模板复用。
立即学习“Java免费学习笔记(深入)”;
- 静态导出:直接传入List
,EasyExcel调用write()自动映射;POI需循环创建Row/Cell并设值 - 动态列:EasyExcel支持WriteSheet + Table组合;POI需先获取列头List,再动态生成表头行
- 模板导出:用FillConfig(EasyExcel)或XSSFSheet.copyRows()(POI)填充已有样式模板
- 超大数据导出:启用流式写入(EasyExcel的writeWithTemp()=true)或分批查询+分Sheet写入
常见问题与规避
实际项目中,中文乱码、日期解析异常、空指针、OOM是最常遇到的问题。
- Excel日期读成数字:EasyExcel默认转LocalDateTime,POI需用DateUtil.getJavaDate() + 格式化
- 空单元格导致NPE:DTO字段加@Nullable,或在监听器中判空后设默认值
- 导出文件下载乱码:响应头设Content-Disposition: attachment; filename*=UTF-8''xxx.xlsx
- 内存溢出:禁用POI的setUseSharedStringsTable(true)(新版默认false),EasyExcel默认SXSSF模式










