springboot+easyexcel实现固定表头+动态表头的数据导出

### SpringBoot 和 EasyExcel 实现固定表头与动态表头的数据导出 #### 一、背景介绍 在实际开发场景中，数据导出的需求通常较为复杂，不仅涉及简单的字段映射，还可能需要支持 **固定表头** 和 **动态表头** 的组合。通过 `SpringBoot` 集成 `EasyExcel` 可以高效完成此类需求。 --- #### 二、实现方案详解 ##### 1. 固定表头的定义 固定表头是指在 Excel 文件中始终存在的列名或分组信息。可以通过 `@ExcelProperty` 注解指定固定的表头内容及其索引位置[^1]。 以下是基于案例中的实体类扩展： ```java @Data @NoArgsConstructor @AllArgsConstructor @Builder public class User implements Serializable { @ExcelProperty(value = {"用户基本信息", "用户名"}, index = 0) private String userName; @ExcelProperty(value = {"用户基本信息", "年龄"}, index = 1) private Integer age; @ExcelProperty(value = {"用户基本信息", "地址"}, index = 2) private String address; @ExcelProperty(value = {"用户基本信息", "生日"}, index = 3) private Date birthday; } ``` 上述代码展示了如何利用嵌套数组形式设置多级固定表头结构[^1]。 --- ##### 2. 动态表头的支持 对于动态表头，可以采用自定义写入逻辑的方式，在不修改实体类的情况下灵活调整表头内容。具体步骤如下： ###### （1）创建动态表头配置对象 定义一个用于存储动态表头信息的对象，例如： ```java import com.alibaba.excel.annotation.ExcelProperty; public class DynamicHeaderConfig { private List<String[]> headers; // 存储动态表头的二维数组 public DynamicHeaderConfig(List<String[]> headers) { this.headers = headers; } public List<String[]> getHeaders() { return headers; } } ``` ###### （2）编写自定义监听器 通过继承 `com.alibaba.excel.write.metadata.holder.WriteSheetHolder` 或者直接操作 `WriteTable` 来控制动态表头的行为。 示例代码片段： ```java import com.alibaba.excel.EasyExcel; import com.alibaba.excel.write.builder.ExcelWriterBuilder; import com.alibaba.excel.write.metadata.WriteSheet; import java.util.ArrayList; import java.util.List; public class ExportService { public void exportWithDynamicHeader(String filePath, List<User> data, List<String[]> dynamicHeaders) { // 创建 writer 对象 ExcelWriterBuilder excelWriterBuilder = EasyExcel.write(filePath); WriteSheet writeSheet = EasyExcel.writerSheet("用户信息").build(); // 添加动态表头 for (String[] headerRow : dynamicHeaders) { excelWriterBuilder.head(headerRow); } // 执行写入 excelWriterBuilder.sheet(writeSheet.getSheetNo(), writeSheet.getSheetName()) .doWrite(data); } } ``` 在此过程中，`dynamicHeaders` 参数允许开发者传入任意数量的动态表头行，从而满足不同业务场景下的需求。 --- ##### 3. 组合固定表头与动态表头 当需要同时支持固定表头和动态表头时，可以在程序运行期间先加载默认的固定表头，再叠加动态部分。最终效果取决于两者的顺序安排以及冲突解决策略。 以下是一个完整的调用实例： ```java public static void main(String[] args) { // 准备测试数据 ArrayList<User> users = new ArrayList<>(); for (int i = 0; i < 10; i++) { User user = new User(); user.setAddress("西安" + i); user.setUserName("张三" + i); user.setBirthday(new Date()); user.setAge(10 + i); users.add(user); } // 定义动态表头 List<String[]> dynamicHeaders = new ArrayList<>(); dynamicHeaders.add(new String[]{"额外信息"}); dynamicHeaders.add(new String[]{"备注"}); // 调用服务方法执行导出 ExportService service = new ExportService(); service.exportWithDynamicHeader("D:\\用户_带动态表头.xlsx", users, dynamicHeaders); } ``` 此代码实现了将固定表头（来自实体类注解）与动态表头相结合的功能[^1]。 --- #### 三、注意事项 - 如果存在重复的表头名称，则需手动调整其显示层次或者添加唯一标识符。 - 使用日期类型字段时应确保格式化工具链正常工作，推荐依赖 `SimpleDateFormat` 明确设定输出样式。 - 大规模数据量下建议启用流式写法优化性能表现。 ---