SpringBoot + EasyExcel 导出文件怎么导出？有哪些好处？

还记得刚入行时，一听到 "Excel 导出" 就条件反射地冒冷汗 ——POI 那套 API 跟迷宫似的，CellStyle 能把人调得眼冒金星，大数据量导出时内存飙到 90% 的恐惧至今难忘。直到去年被产品经理逼到墙角时，发现了 Alibaba 的 EasyExcel，从此打开新世界的大门。

今天就把这套 "导出救命锦囊" 分享给大家，顺便穿插点当年踩坑的段子，让咱们在笑声中搞定 Excel 导出。

一、先给项目把 EasyExcel 的 "脉"—— 环境整合篇

1. 引入依赖：别让 Maven 耍小脾气

首先在pom.xml里加依赖，这里得注意版本兼容性。我曾试过用最新版 EasyExcel 配老 Spring Boot，结果像小孩打架似的报错不断。建议直接抄作业：

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

加完记得刷新 Maven，这玩意儿有时候像闹情绪的女朋友，得哄着来。

2. 创建实体类：给数据贴 "xxx"

咱得先定义 Excel 里每一列的数据结构，就像给每个字段发一张 "座位牌"。比如导出用户信息：

@Datapublic class UserExcelVO {    // 这里是表头名称，宽度设置成20，就像给单元格定制合适的衣服尺码    @ExcelProperty(value = "用户ID", index = 0)    private Long userId;        // 用转换器把日期变成"yyyy-MM-dd"格式，不然Excel会显示成奇怪的数字    @ExcelProperty(value = "注册时间", index = 1)    @DateTimeFormat("yyyy-MM-dd")    private Date registerTime;        // 自定义转换器，把性别0/1转成"男""女"，不然产品经理会追着你改需求    @ExcelProperty(value = "性别", index = 2)    @Converter(SexConverter.class)    private Integer sex;}

这里的@ExcelProperty就像给数据贴标签，index是列顺序，可别标错号，不然数据错位时你会怀疑人生 —— 我曾把金额和年龄的位置搞反，被财务小姐姐骂得狗血淋头。

3. 编写导出工具类：把重复工作打包成 "瑞士军刀"

把通用导出逻辑封装起来，以后每次导出就像拧瓶盖一样简单。创建EasyExcelUtils：

public class EasyExcelUtils {    public static <T> void exportExcel(HttpServletResponse response,                                       List<T> dataList,                                       Class<T> clazz,                                       String fileName) throws IOException {        response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");        response.setCharacterEncoding("utf-8");        // 文件名得处理中文，不然下载下来是乱码，别问我怎么知道的（摸了摸头上的包）        fileName = URLEncoder.encode(fileName, "UTF-8").replaceAll("\+", "%20");        response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");                // 这里用EasyExcel.write()就像启动一个Excel生成器，简单到让我怀疑人生        EasyExcel.write(response.getOutputStream(), clazz)                .sheet("数据报表")                .doWrite(dataList);    }}

从此告别每次导出都写重复代码的日子，就像有了自动咖啡机，再也不用手动磨豆子了。

二、实战演练：从 "普通导出" 到 "花里胡哨" 的需求突围

1. 基础导出：先搞定 "刚需"

在 Controller 里调用工具类，就像把食材放进微波炉：

@GetMapping("/exportUser")public void exportUser(HttpServletResponse response) throws IOException {    List<UserExcelVO> dataList = userService.getUserListForExport(); // 假设这是从数据库查的数据    EasyExcelUtils.exportExcel(response, dataList, UserExcelVO.class, "用户信息表");}

第一次跑通时，我对着屏幕傻笑了三分钟 —— 七年了，终于不用跟 POI 的 N 个参数较劲了！

2. 复杂表头：当领导突然说 "再加一层分类"

有时候表头需要多级结构，比如 "用户信息" 下分 "基本信息"" 联系方式 "。这时候需要用@ExcelProperty的数组形式：

@Datapublic class ComplexHeaderVO {    @ExcelProperty({"用户信息", "用户ID"})    private Long userId;        @ExcelProperty({"用户信息", "姓名"})    private String userName;        @ExcelProperty({"联系方式", "手机号"})    private String phone;        @ExcelProperty({"联系方式", "邮箱"})    private String email;}

看着生成的两层表头，突然想起当年被产品经理临时加需求的夜晚，而现在，EasyExcel 让我能优雅应对，甚至想主动问："还有什么花样？爸爸接得住！"

3. 合并单元格：玩一把 "Excel 拼图游戏"

比如导出报表时需要合并相同内容的单元格，这时候得自定义CellWriteHandler。举个例子，合并连续相同的部门名称：

public class MergeCellHandler implements CellWriteHandler {    @Override    public void afterCellDispose(CellWriteHandlerContext context) {        // 这里省略具体实现，核心是通过行号和列号判断是否合并        // 就像拼拼图，找到相同的部分粘在一起    }}

在导出时注册这个处理器：

EasyExcel.write(...)    .registerWriteHandler(new MergeCellHandler())    .doWrite(...);

第一次实现合并单元格时，我兴奋地在工位上哼起了《爱拼才会赢》，毕竟以前用 POI 写合并代码能写满两屏，现在轻松多了。

4. 自定义格式：让数据 "穿上漂亮衣服"

比如金额需要显示成 "¥1,000.00"，日期要显示成 "2025 年 5 月 29 日"。除了前面提到的@DateTimeFormat，数值格式可以用@NumberFormat：

@ExcelProperty("金额")@NumberFormat("#,##0.00")private Double amount;

看着导出的规范格式，突然想起当年因为金额格式不对被财务打回 13 次的惨案，现在终于能扬眉吐气了。

5. 大数据量导出：别让内存 "撑破肚皮"

当数据量超过 10 万条时，直接导出会把内存撑爆，这时候得用流式处理。EasyExcel 贴心地支持分页导出，每次查 1000 条，分批次写入：

EasyExcel.write(response.getOutputStream(), UserExcelVO.class)    .sheet("大数据报表")    .registerWriteHandler(...) // 可选的样式处理器    .doWrite(new AnalysisContext() -> {        // 这里每次调用获取一页数据，直到没有数据为止        List<UserExcelVO> pageData = userService.getPageData(analysisContext.readRowHolder().getRowIndex());        return pageData;    });

记得当年用 POI 导出 20 万条数据，服务器直接内存溢出，被运维大哥拎着键盘来问罪，现在有了流式处理，再也不怕大数据量了。

三、避坑指南：这些 "暗礁" 别踩

1. 依赖冲突：当 Maven 开始 "闹别扭"

如果引入了旧版 POI 依赖，可能会和 EasyExcel 的 POI 版本冲突。这时候别慌，用mvn dependency:tree命令排查，然后在pom.xml里用排除冲突项，就像哄孩子一样，把捣乱的依赖赶走。

2. 注解优先级：别让 "标签" 打架

@ExcelProperty可以写在字段上或方法上，建议统一写在字段上，不然容易混乱。我曾在一个类里混合使用，结果导出时字段顺序乱成一锅粥，debug 了两小时才发现问题。

3. 样式设置：别把 Excel 变成 "花脸猫"

虽然 EasyExcel 支持自定义样式，但别过度使用，比如给每个单元格设置不同颜色，导出的 Excel 可能打不开。样式设置要适度，就像化妆，自然美才是真的美。

四、总结：从 "被 Excel 支配" 到 "掌控导出自由"

折腾了七年 Excel 导出，从 POI 的磕磕绊绊到 EasyExcel 的丝滑体验，不得不感叹开源工具的伟大。现在每次接到导出需求，我都能淡定地说："放马过来吧，不管是复杂表头、大数据量还是格式要求，咱这工具都能搞定。"

最后送大家一句口诀：EasyExcel 真的妙，注解一标数据跳，工具类里封装好，导出从此没烦恼。复杂需求别害怕，处理器来把忙帮，踩过的坑我来扛，各位兄弟放心上！