解决 EasyExcel 首次导出耗时过长问题
1. 问题背景
在生产环境中观察到，每当应用重启后，用户触发的第一次Excel 导出任务响应极慢（耗时可能达到 5-10 秒），但后续的导出请求速度恢复正常。这种“冷启动”现象严重影响了用户体验。
2. 问题排查
为了定位耗时节点，我们在导出逻辑的关键位置增加了时间戳日志。
2.1 埋点代码
publicvoidexportData(HttpServletResponseresponse,List<ExportCredentialVO>data){longstartTime=System.currentTimeMillis();log.info("开始执行导出流程...");try{// 关键耗时监控点longstep1=System.currentTimeMillis();ExcelWriterSheetBuilderwriterBuilder=EasyExcel.write(response.getOutputStream(),ExportCredentialVO.class).sheet("凭证数据");log.info("Step 1: EasyExcel.write 初始化耗时: {}ms",(System.currentTimeMillis()-step1));longstep2=System.currentTimeMillis();writerBuilder.doWrite(data);log.info("Step 2: 数据写入与流传输耗时: {}ms",(System.currentTimeMillis()-step2));}catch(IOExceptione){log.error("导出失败",e);}log.info("导出流程总耗时: {}ms",(System.currentTimeMillis()-startTime));}2.2 日志结果分析
应用重启后，第一次导出的日志输出如下：
2025-12-25 10:00:01.123 INFO - 开始执行导出流程... 2025-12-25 10:00:06.456 INFO - Step 1: EasyExcel.write 初始化耗时: 5333ms 2025-12-25 10:00:06.789 INFO - Step 2: 数据写入与流传输耗时: 333ms 2025-12-25 10:00:06.790 INFO - 导出流程总耗时: 5667ms结论：耗时主要集中在EasyExcel.write()初始化阶段，而非数据查询或实际写入阶段。
3. 原因分析
经过调研与源码追踪，确认首次执行慢主要由以下原因导致：
- 类加载与反射解析：EasyExcel 需要解析实体类（如
ExportCredentialVO）上的@ExcelProperty注解，并构建元数据模型，这些模型在第一次运行后会缓存。 - 字体初始化：底层 POI 在处理样式时，会调用系统 JDK 的字体库。在 Linux 环境下，第一次加载物理字体并构建字体映射关系非常耗时。
- JIT 编译：JVM 尚未对热点代码进行即时编译（JIT），初始运行处于解释执行模式。
4. 解决方案：异步预热
通过实现 Spring Boot 的ApplicationRunner接口，在应用启动完成后自动模拟一次微量导出，强制触发类加载、注解解析及字体初始化。
4.1 核心代码实现
importcom.alibaba.excel.EasyExcel;importlombok.extern.slf4j.Slf4j;importorg.springframework.boot.ApplicationArguments;importorg.springframework.boot.ApplicationRunner;importorg.springframework.stereotype.Component;importjava.io.ByteArrayOutputStream;importjava.util.ArrayList;/** * EasyExcel 预热组件 * 解决重启后首次导出慢的问题 */@Slf4j@ComponentpublicclassEasyExcelWarmUpimplementsApplicationRunner{@Overridepublicvoidrun(ApplicationArgumentsargs){log.info("开始执行 EasyExcel 预热...");longstart=System.currentTimeMillis();try(ByteArrayOutputStreamout=newByteArrayOutputStream()){// 模拟一次极小规模的导出（空数据）// 目的：触发 ExportCredentialVO 的注解解析、相关类加载及系统字体加载EasyExcel.write(out,ExportCredentialVO.class).sheet("WarmupSheet").doWrite(newArrayList<>());log.info("EasyExcel 预热完成，耗时: {}ms",(System.currentTimeMillis()-start));}catch(Exceptione){log.error("EasyExcel 预热失败",e);}}}5. 实施效果
引入预热机制后，用户在应用重启后的第一次导出耗时日志变为：
2025-12-25 10:05:20.001 INFO - 开始执行导出流程... 2025-12-25 10:05:20.050 INFO - Step 1: EasyExcel.write 初始化耗时: 49ms 2025-12-25 10:05:20.150 INFO - Step 2: 数据写入与流传输耗时: 100ms 2025-12-25 10:05:20.151 INFO - 导出流程总耗时: 150ms结果：首次导出响应速度提升了95%以上，完美解决了卡顿现象。
