EasyExcel多Sheet读取问题分析与解决方案

问题背景

在使用阿里巴巴开源的EasyExcel库（版本3.2.1及以上）处理Excel文件时，开发者遇到了一个典型的多Sheet读取问题：当尝试读取包含多个Sheet的Excel文件时，只有第一个Sheet的数据被成功读取，而后续Sheet的数据无法获取。这个问题在多个版本（3.2.1、3.3.4、4.0.1）中都存在。

问题现象

开发者提供的代码示例展示了如何同时读取两个Sheet：

1. 第一个Sheet名为"By Deliverables martix"
2. 第二个Sheet名为"Media inno OLB"

每个Sheet都有对应的监听器类（CreativeQuotationAccFeeTmpDeliverablesListener和CreativeQuotationAccFeeTmpMediaInnoListener）来处理读取到的数据。然而实际运行时，只有第一个Sheet的数据被处理，第二个Sheet的监听器方法完全没有被调用。

问题分析

经过深入排查，发现问题根源在于监听器中重写的hasNext方法。具体表现为：

1. 第一个Sheet的监听器（CreativeQuotationAccFeeTmpDeliverablesListener）中重写了hasNext方法
2. 在处理过程中，当满足某些业务条件时，该方法返回false
3. 这个返回值不仅影响了当前Sheet的处理，还意外终止了整个Excel文件的读取过程
4. 导致后续Sheet的监听器完全不被执行

技术原理

EasyExcel的多Sheet读取机制是基于事件驱动的流式处理模型。当调用reader.read(sh1, sh2)时：

1. EasyExcel会按顺序处理每个Sheet
2. 对于每个Sheet，会触发对应监听器的各个方法（invoke、doAfterAllAnalysed等）
3. hasNext方法的设计初衷是让开发者可以控制是否继续读取当前Sheet的下一行数据
4. 但在实现上，返回false会终止整个读取流程，而不仅仅是当前Sheet

解决方案

针对这个问题，有以下几种解决方案：

方案一：移除hasNext方法的重写

如果业务逻辑允许，最简单的解决方案是移除监听器中重写的hasNext方法。这样EasyExcel会使用默认实现，确保所有Sheet都能被完整读取。

// 移除这个方法的重写
// @Override
// public boolean hasNext(AnalysisContext context) {
//     return nextBreakFlag;
// }

方案二：修改hasNext的实现逻辑

如果业务确实需要控制行读取，可以修改hasNext方法的实现，确保它不会永久返回false：

@Override
public boolean hasNext(AnalysisContext context) {
    // 添加对当前Sheet的判断
    if(context.readSheetHolder().getSheetName().equals("By Deliverables martix")) {
        return nextBreakFlag;
    }
    return true;
}

方案三：使用单独的读取流程

对于复杂的业务场景，可以考虑为每个Sheet单独创建读取流程：

// 第一个Sheet
ExcelReader reader1 = EasyExcel.read(inputStream).build();
reader1.read(sh1);
reader1.finish();

// 第二个Sheet
ExcelReader reader2 = EasyExcel.read(inputStream).build();
reader2.read(sh2);
reader2.finish();

额外问题：批注和合并单元格信息读取

在问题中还提到了另一个相关问题：无法读取Excel中的批注和合并单元格信息。这是因为：

1. 需要在读取时显式指定extraRead类型
2. 确保监听器中正确实现了extra方法
3. 注意extra方法只会在读取到对应类型的额外信息时被调用

正确的使用方式：

EasyExcel.read(inputStream)
    .extraRead(CellExtraTypeEnum.COMMENT, CellExtraTypeEnum.MERGE)
    .sheet("SheetName")
    .registerReadListener(yourListener)
    .build();

最佳实践建议

1. 谨慎重写hasNext方法，确保理解其对整个读取流程的影响
2. 对于多Sheet读取，考虑使用单独的读取流程以避免相互干扰
3. 处理额外信息时，明确指定需要的类型并正确实现回调方法
4. 在复杂业务场景下，考虑将Excel读取逻辑与业务逻辑分离

总结

EasyExcel作为一款优秀的Excel处理工具，在大多数场景下都能提供良好的使用体验。但在处理多Sheet和特殊Excel特性时，开发者需要深入理解其内部工作机制，才能避免类似问题。通过本文的分析和解决方案，希望能帮助开发者更好地使用EasyExcel处理复杂Excel文件。