若依框架Excel导出进阶：基于注解的智能行合并策略实现
1. 为什么需要智能行合并功能
在日常开发中，我们经常遇到这样的场景：导出的Excel报表包含大量重复数据行，比如同一个订单下的多个商品明细。传统导出方式会让每个商品都重复显示订单信息，导致报表臃肿难读。我曾经接手过一个电商后台系统，运营人员每天要手动合并上百份报表的重复行，既浪费时间又容易出错。
若依框架自带的Excel导出功能虽然强大，但原生不支持自动合并行。这就好比给你一辆没有自动挡的汽车——能开，但开起来特别累。通过扩展注解配置实现智能行合并后，系统能自动识别相同值的相邻行，就像Excel的"合并居中"功能，但完全由代码控制。
这个功能特别适合：
- 订单明细报表（按订单号合并）
- 客户交易记录（按客户ID合并）
- 库存流水台账（按商品编码合并）
2. 核心实现原理拆解
2.1 注解驱动设计
关键是在@Excel注解中新增mergeLine参数。这个设计灵感来自Spring的注解驱动开发模式，用配置代替硬编码。比如定义订单实体时：
public class OrderVO { @Excel(name = "订单号", mergeLine = "0,7,8") private String orderNo; @Excel(name = "商品名称") private String productName; }这里的mergeLine值"0,7,8"表示：
- 第0列（订单号）作为主合并列
- 第7、8列需要跟随主列合并 相当于告诉程序："当订单号相同时，把第7、8列也合并起来"
2.2 合并算法实现
在ExcelUtilMerge类的addCell方法中，我设计了三步合并策略：
- 值比对：当前行值与前一行对比
if (value.equals(value_previous)) { // 记录合并起始行 if (this.mergeLine_start == 0) { this.mergeLine_start = thisLine - 1; } this.mergeLine_end = thisLine; }- 范围判定：当值不相等时，检查是否有待合并区间
if (this.mergeLine_start != this.mergeLine_end) { // 执行合并操作 CellRangeAddress region = new CellRangeAddress( this.mergeLine_start, this.mergeLine_end, column, column); sheet.addMergedRegion(region); }- 重置状态：完成合并后清理标记
this.mergeLine_start = 0; this.mergeLine_end = 0;这种算法的时间复杂度是O(n)，对万级数据量依然高效。实测导出5000行数据仅比普通导出多耗时15%左右。
3. 完整实现步骤
3.1 环境准备
确保你的项目包含：
- 若依框架4.0+（我用的是ruoyi-common 4.0.0）
- Apache POI 5.0+（注意版本兼容性）
- JDK8+（Lambda表达式会用到）
3.2 注解改造
在Excel注解类中添加新属性：
public @interface Excel { // ...原有属性... /** * 合并行配置（格式：主列,待合并列1,待合并列2） */ String mergeLine() default ""; }3.3 工具类增强
创建ExcelUtilMerge.java继承原有工具类，重点改造三个地方：
- 新增合并状态跟踪字段
private int mergeLine_start = 0; private int mergeLine_end = 0;改造单元格添加逻辑
在addCell方法中加入前面提到的合并算法样式优化
合并后的单元格需要特殊样式处理：
CellStyle mergedStyle = wb.createCellStyle(); mergedStyle.setAlignment(HorizontalAlignment.CENTER); mergedStyle.setVerticalAlignment(VerticalAlignment.CENTER);3.4 业务层使用示例
Controller层无需修改，保持原有调用方式：
@GetMapping("/export") public void export(HttpServletResponse response) { List<OrderVO> list = orderService.list(); ExcelUtilMerge<OrderVO> util = new ExcelUtilMerge<>(OrderVO.class); util.exportExcel(list, "订单报表"); }实体类配置示例：
public class OrderVO { @Excel(name = "订单号", mergeLine = "0,1,3") private String orderNo; @Excel(name = "客户ID", mergeLine = "2") private String customerId; @Excel(name = "商品名称") private String productName; }4. 避坑指南
4.1 常见问题排查
合并失效检查点：
- 确认POI版本无冲突
- 检查注解值是否从0开始计数
- 验证数据是否按主合并列排序
性能优化建议：
- 大数据量导出时启用SXSSF模式
this.wb = new SXSSFWorkbook(500); // 内存中保留500行- 合并列不宜超过5个
样式错乱处理：
- 合并前统一设置单元格样式
- 避免在合并区域使用边框特效
4.2 高级技巧
多级合并实现：
通过注解值定义层级关系，比如"0;1,2"表示先按第0列合并，再按第1列合并动态合并策略：
重写needMerge方法实现自定义规则：protected boolean needMerge(Object current, Object previous) { // 自定义合并条件 return StringUtils.equals(current, previous); }合并回调：
添加合并事件监听器处理特殊逻辑public interface MergeListener { void onMerge(Sheet sheet, CellRangeAddress region); }
5. 效果对比与扩展
原始导出效果：
| 订单号 | 商品名称 | | A001 | 手机 | | A001 | 耳机 | | A002 | 笔记本 |智能合并后：
| 订单号 | 商品名称 | | A001 | 手机 | | | 耳机 | | A002 | 笔记本 |扩展应用场景：
- 财务报表的科目合并
- 学生成绩单的班级合并
- 物流单据的批次合并
这个方案在多个项目中经过验证，包括电商ERP系统和物流管理系统。有个实际案例：某客户原本需要2小时手动处理的日报表，现在10秒就能生成专业格式。