Spring Boot 实现 Excel 导出功能（支持前端下载 + 文件流）
🧠 一、为什么用 EasyExcel？
在 Java 开发中，操作 Excel 的框架主要有：
-
Apache POI（经典但慢、内存占用大）
-
JXL（老旧不维护）
-
Alibaba EasyExcel（阿里出品，性能好，写入快，注解灵活）
EasyExcel 优点：
-
注解式开发，简单直观
-
支持大量数据写入不 OOM
-
支持复杂表头、样式、合并单元格
今天我们用 EasyExcel 实现后端导出 Excel 文件并支持前端下载。
📦 二、添加依赖（Maven）
<dependency><groupId>com.alibaba</groupId><artifactId>easyexcel</artifactId><version>3.3.2</version>
</dependency>
🧱 三、定义导出数据结构
创建一个导出用的数据对象（VO），使用 @ExcelProperty 注解指定表头名和字段顺序：
package com.example.excel.vo;import com.alibaba.excel.annotation.ExcelProperty;
import lombok.Data;@Data
public class UserExportVO {@ExcelProperty(value = "用户名", index = 0)private String username;@ExcelProperty(value = "手机号", index = 1)private String phone;@ExcelProperty(value = "注册时间", index = 2)private String registerTime;
}
🖥️ 四、后端导出接口
创建一个下载接口，核心是将 Excel 写入 HttpServletResponse 输出流。
@GetMapping("/api/export")
public void exportUserList(HttpServletResponse response) throws IOException {List<UserExportVO> dataList = getMockData(); // 获取数据（或从数据库查询）// 设置响应头response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");response.setCharacterEncoding("utf-8");String fileName = URLEncoder.encode("用户信息导出", "UTF-8").replaceAll("\\+", "%20");response.setHeader("Content-disposition", "attachment;filename*=utf-8''" + fileName + ".xlsx");// 写数据到响应输出流EasyExcel.write(response.getOutputStream(), UserExportVO.class).sheet("用户信息").doWrite(dataList);
}
✅ 示例 mock 数据方法
private List<UserExportVO> getMockData() {List<UserExportVO> list = new ArrayList<>();for (int i = 1; i <= 10; i++) {UserExportVO user = new UserExportVO();user.setUsername("用户" + i);user.setPhone("188888888" + i);user.setRegisterTime("2025-04-10");list.add(user);}return list;
}
🌐 五、前端调用方式
方式一：直接触发下载（window.open）
window.open('/api/export', '_blank');
方式二：使用 Axios 下载 Blob
axios({url: '/api/export',method: 'GET',responseType: 'blob'
}).then((res) => {const blob = new Blob([res.data], { type: res.headers['content-type'] });const link = document.createElement('a');link.href = window.URL.createObjectURL(blob);link.download = '用户信息.xlsx';link.click();
});
🧩 六、常见问题解答
❓1. 文件名乱码？
✅ 使用 URLEncoder.encode(fileName, "UTF-8") 编码，并加 replaceAll("\\+", "%20")。
❓2. 表头顺序错乱？
✅ 使用 @ExcelProperty(index = x) 指定每列的顺序。
❓3. 导出文件打不开？
✅ 确保响应头设置正确，文件类型为 application/vnd.openxmlformats-officedocument.spreadsheetml.sheet。
❓4. 导出大量数据内存溢出？
✅ EasyExcel 默认使用 streaming write，但建议分页获取数据、分批写入。
📌 七、结语
到这里，我们已经完成了：
✅ 使用 EasyExcel 构建导出数据结构
✅ 实现了后端文件流输出接口
✅ 支持前端触发导出并自动下载 Excel
📁 导出功能在企业系统中非常常见，如果你在写后台管理系统，这篇教程绝对值得收藏！