别再手动处理Excel了！SpringBoot + EasyExcel 3.x 实现数据导入导出的完整配置流程

SpringBoot与EasyExcel 3.x实战：打造高效数据导入导出系统

在数据处理领域，Excel文件依然是企业级应用中最常见的数据交换格式之一。传统的手工操作不仅效率低下，还容易出错。本文将带你深入探索如何利用SpringBoot与EasyExcel 3.x构建一套完整的Excel数据导入导出系统，彻底告别繁琐的手工操作。

1. 环境准备与基础配置

开始之前，我们需要搭建一个标准的SpringBoot项目环境。这里假设你已经具备基本的SpringBoot开发经验，我们将重点放在EasyExcel的集成与配置上。

首先，在项目的pom.xml中添加必要的依赖：

<dependency> <groupId>com.alibaba</groupId> <artifactId>easyexcel</artifactId> <version>3.1.1</version> </dependency> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>

EasyExcel 3.x相较于早期版本，在性能和功能上都有显著提升。以下是几个关键改进点：

• 内存优化：采用流式读写模型，大幅降低内存消耗
• 注解增强：支持更灵活的样式和格式控制
• 扩展性提升：提供更多自定义接口和回调函数

提示：在实际项目中，建议同时引入Lombok简化代码，并添加Swagger用于API文档生成。

2. 数据导出：从数据库到Excel

数据导出是报表系统的核心功能。我们将构建一个完整的导出流程，包括数据查询、格式定义和文件生成。

2.1 定义导出数据结构

首先创建导出数据的VO类，使用EasyExcel注解定义Excel的表头格式：

@Data @HeadStyle(fillPatternType = FillPatternType.SOLID_FOREGROUND, fillForegroundColor = 42) @HeadFontStyle(fontHeightInPoints = 12, bold = true) public class UserExportVO { @ExcelProperty(value = "用户ID", index = 0) @ColumnWidth(15) private Long id; @ExcelProperty(value = "用户名", index = 1) @ColumnWidth(20) private String username; @ExcelProperty(value = "创建时间", index = 2) @ColumnWidth(25) @DateTimeFormat("yyyy-MM-dd HH:mm:ss") private Date createTime; }

2.2 构建导出服务

接下来实现数据查询和导出逻辑：

@RestController @RequestMapping("/export") public class ExportController { @Autowired private UserService userService; @GetMapping("/users") public void exportUsers(HttpServletResponse response) throws IOException { List<UserExportVO> data = userService.getAllUsersForExport(); String fileName = "用户列表_" + System.currentTimeMillis(); response.setContentType("application/vnd.ms-excel"); response.setCharacterEncoding("utf-8"); response.setHeader("Content-disposition", "attachment;filename=" + URLEncoder.encode(fileName, "UTF-8") + ".xlsx"); EasyExcel.write(response.getOutputStream(), UserExportVO.class) .sheet("用户数据") .doWrite(data); } }

2.3 高级导出功能

对于更复杂的需求，EasyExcel提供了丰富的自定义选项：

• 自定义样式：通过WriteHandler接口实现
• 多Sheet导出：链式调用多个sheet方法
• 大数据量导出：使用分页查询+分批写入策略

// 自定义表头样式示例 public class CustomSheetHandler implements SheetWriteHandler { @Override public void afterSheetCreate(WriteWorkbookHolder writeWorkbookHolder, WriteSheetHolder writeSheetHolder) { // 自定义样式逻辑 } } // 使用自定义样式 EasyExcel.write(outputStream, UserExportVO.class) .registerWriteHandler(new CustomSheetHandler()) .sheet("用户数据") .doWrite(data);

3. 数据导入：从Excel到数据库

数据导入是另一个常见需求，特别是批量数据录入场景。EasyExcel的事件监听模型使其在处理大文件时依然保持高效。

3.1 定义导入模型

创建与Excel列对应的数据模型：

@Data public class UserImportDTO { @ExcelProperty(index = 0) private String username; @ExcelProperty(index = 1) private String password; @ExcelProperty(index = 2) @DateTimeFormat("yyyy-MM-dd") private Date registerDate; }

3.2 实现数据监听器

核心的导入逻辑通过实现AnalysisEventListener来完成：

public class UserImportListener extends AnalysisEventListener<UserImportDTO> { private static final int BATCH_SIZE = 100; private List<UserImportDTO> cachedList = new ArrayList<>(BATCH_SIZE); @Autowired private UserService userService; @Override public void invoke(UserImportDTO data, AnalysisContext context) { // 数据校验逻辑 if (StringUtils.isEmpty(data.getUsername())) { throw new ExcelAnalysisException("用户名不能为空"); } cachedList.add(data); if (cachedList.size() >= BATCH_SIZE) { saveBatch(); cachedList.clear(); } } @Override public void doAfterAllAnalysed(AnalysisContext context) { if (!cachedList.isEmpty()) { saveBatch(); } } private void saveBatch() { userService.batchImport(cachedList); } }

3.3 构建导入接口

最后创建接收文件的控制器：

@PostMapping("/import/users") public String importUsers(@RequestParam("file") MultipartFile file) throws IOException { EasyExcel.read(file.getInputStream(), UserImportDTO.class, new UserImportListener()) .sheet() .doRead(); return "导入成功"; }

4. 高级功能与性能优化

掌握了基础功能后，我们来探讨一些高级应用场景和性能优化技巧。

4.1 动态表头处理

某些业务场景需要动态生成表头，可以通过编程方式实现：

List<List<String>> head = new ArrayList<>(); head.add(Collections.singletonList("动态列1")); head.add(Collections.singletonList("动态列2")); List<List<Object>> data = new ArrayList<>(); data.add(Arrays.asList("值1", "值2")); EasyExcel.write(outputStream) .head(head) .sheet() .doWrite(data);

4.2 大数据量处理策略

处理百万级数据时，需要特殊策略避免内存溢出：

• 分片读取：配置ReadWorkbook的readCacheSize
• 分批写入：控制每批次写入的数据量
• 异步处理：结合消息队列实现后台处理

// 分片读取配置示例 ReadWorkbook readWorkbook = new ReadWorkbook(); readWorkbook.setReadCacheSize(5000); EasyExcel.read(inputStream, UserImportDTO.class, listener) .readWorkbook(readWorkbook) .sheet() .doRead();

4.3 异常处理与数据校验

健壮的导入系统需要完善的异常处理机制：

• 格式校验：使用JSR-303注解
• 业务校验：在监听器中实现
• 错误收集：构建详细的错误报告

@Data public class UserImportDTO { @NotBlank(message = "用户名不能为空") @ExcelProperty(index = 0) private String username; @Pattern(regexp = "^(?=.*[A-Za-z])(?=.*\\d)[A-Za-z\\d]{8,}$", message = "密码必须包含字母和数字，且长度至少8位") @ExcelProperty(index = 1) private String password; }

5. 实战案例：完整的企业级解决方案

结合前面介绍的技术点，我们构建一个完整的企业级Excel处理方案。

5.1 通用导出工具类

封装一个可复用的导出工具：

public class ExcelExportUtil { public static <T> void export(HttpServletResponse response, String fileName, String sheetName, Class<T> clazz, List<T> data, WriteHandler... handlers) throws IOException { response.setContentType("application/vnd.ms-excel"); response.setCharacterEncoding("utf-8"); response.setHeader("Content-disposition", "attachment;filename=" + URLEncoder.encode(fileName, "UTF-8") + ".xlsx"); ExcelWriterBuilder writerBuilder = EasyExcel.write(response.getOutputStream(), clazz) .sheet(sheetName); for (WriteHandler handler : handlers) { writerBuilder.registerWriteHandler(handler); } writerBuilder.doWrite(data); } }

5.2 带模板的复杂导出

对于格式复杂的报表，可以先准备模板文件：

public void exportWithTemplate(HttpServletResponse response) throws IOException { String templateFileName = "template.xlsx"; String fileName = "复杂报表_" + System.currentTimeMillis() + ".xlsx"; response.setContentType("application/vnd.ms-excel"); response.setCharacterEncoding("utf-8"); response.setHeader("Content-disposition", "attachment;filename=" + URLEncoder.encode(fileName, "UTF-8")); EasyExcel.write(response.getOutputStream()) .withTemplate(templateFileName) .sheet() .doWrite(() -> { // 返回填充数据 return Collections.singletonList(new HashMap<String, Object>() {{ put("date", LocalDate.now().toString()); put("total", 10000); }}); }); }

5.3 导入结果反馈

改进导入接口，返回详细的处理结果：

@Data public class ImportResult { private int totalCount; private int successCount; private int failCount; private List<String> errorMessages; private String downloadUrl; } @PostMapping("/import/with-result") public ImportResult importWithResult(@RequestParam("file") MultipartFile file) throws IOException { UserImportListener listener = new UserImportListener(); EasyExcel.read(file.getInputStream(), UserImportDTO.class, listener) .sheet() .doRead(); ImportResult result = new ImportResult(); result.setTotalCount(listener.getTotalCount()); result.setSuccessCount(listener.getSuccessCount()); result.setFailCount(listener.getFailCount()); result.setErrorMessages(listener.getErrorMessages()); if (!listener.getErrorMessages().isEmpty()) { String errorFile = saveErrorLog(listener.getErrorDetails()); result.setDownloadUrl("/download/errors/" + errorFile); } return result; }

在实际项目中，我们还需要考虑并发处理、事务管理、日志记录等企业级需求。通过合理设计，这套基于SpringBoot和EasyExcel的方案能够满足绝大多数Excel处理场景，显著提升开发效率和系统稳定性。