Fastexcel 多 Sheet 读取限制行数的正确实现方式

在实际业务开发中，我们经常需要处理包含多个 Sheet 的 Excel 文件，并且可能只需要读取每个 Sheet 的前 N 行数据。本文将以 Fastexcel 项目为例，深入探讨如何正确实现这一功能。

常见误区分析

很多开发者会直接使用以下方式尝试读取所有 Sheet 的前 N 行：

EasyExcel.read(fileName, DemoData.class, new PageReadListener<>(dataList -> {
    // 处理数据
})).numRows(100).sheet().doRead();

这种方式存在两个主要问题：

1. 默认只会读取第一个 Sheet 的数据
2. 当某个 Sheet 行数超过限制时，后续 Sheet 不会被读取

正确实现方案

方案一：读取所有 Sheet 但可能截断

如果业务场景允许在某个 Sheet 行数超过限制时跳过后续 Sheet，可以使用以下简洁写法：

EasyExcel.read(fileName, DemoData.class, new PageReadListener<>(dataList -> {
    // 处理数据
})).numRows(100).doReadAll();

这种方式的优点是代码简洁，但缺点是当遇到行数超限的 Sheet 时，后续 Sheet 将不会被处理。

方案二：确保每个 Sheet 都读取固定行数

如果需要确保每个 Sheet 都读取固定的前 N 行，不受其他 Sheet 影响，应该采用更精确的控制方式：

ExcelReader excelReader = EasyExcel.read(fileName, DemoData.class, 
    new PageReadListener<>(dataList -> {
        // 处理数据
    })).numRows(100).build();

// 获取所有 Sheet
List<ReadSheet> readSheetList = excelReader.excelExecutor().sheetList();

// 逐个处理每个 Sheet
for (ReadSheet readSheet : readSheetList) {
    excelReader.read(readSheet);
}

excelReader.close();

这种方式的优势在于：

1. 每个 Sheet 都会独立处理
2. 某个 Sheet 的行数限制不会影响其他 Sheet
3. 资源管理更精确

性能优化建议

在处理大型 Excel 文件时，还需要注意以下性能优化点：

1. 批量处理：PageReadListener 支持批量处理数据，合理设置 batchSize 可以减少内存消耗
2. 资源释放：务必在 finally 块中关闭 ExcelReader，避免资源泄漏
3. 并行处理：对于特别大的文件，可以考虑使用并行流处理不同 Sheet

总结

正确处理多 Sheet Excel 文件的行数限制需要注意 API 的细节行为。Fastexcel 提供了灵活的读取方式，开发者需要根据具体业务场景选择最合适的实现方案。对于要求精确控制每个 Sheet 读取行数的场景，建议采用逐个 Sheet 处理的方式，这样可以获得最可靠的结果。

记住，良好的异常处理和资源管理是保证程序健壮性的关键，特别是在处理外部文件时更应格外注意。