PhpSpreadsheet分块读取XLSX返回空行问题求助

结合你用PHP7.2+Laravel5.5的环境，以及你提供的ChunkReadFilter代码片段，我梳理了几个导致部分块为空的常见原因和修复方案：

1. 核心问题：readCell方法的过滤逻辑错误 #

你的ChunkReadFilter里的readCell方法代码没写完，但这是决定哪些单元格被读取的关键，大概率是这里的逻辑出了问题。正确的实现应该严格限定当前块的行范围，而且要注意XLSX的行号是从1开始计数的，不是0。

完整的过滤器实现示例：

class ChunkReadFilter implements IReadFilter {
    private $startRow = 0;
    private $endRow = 0;

    // 设置要读取的行范围
    public function setRows($startRow, $chunkSize) {
        $this->startRow = $startRow;
        // 注意：endRow要减1，避免超出预期的块大小（比如startRow=1，chunkSize=10，应该读取1-10行）
        $this->endRow = $startRow + $chunkSize - 1;
    }

    public function readCell($column, $row, $worksheetName = '') {
        // 仅返回当前块范围内的行
        if ($row >= $this->startRow && $row <= $this->endRow) {
            return true;
        }
        return false;
    }
}

常见坑点： #

• 行号计数错误：如果你的startRow从0开始设置，会直接跳过第一行，还会导致后续块的范围错位，出现空块。
• endRow计算未减1：比如startRow=1，chunkSize=10，如果endRow=1+10=11，会读取1-11行（共11行），当接近文件末尾时，就会读到空行组成的块。

2. 分块读取时的调用逻辑问题 #

即使过滤器正确，调用时如果没重置状态或处理边界，也会出现空块。以下是正确的Laravel环境下的调用示例：

use PhpOffice\PhpSpreadsheet\IOFactory;

$inputFile = storage_path('app/your-file.xlsx');
$chunkSize = 100; // 每次读取100行

// 初始化读取器和过滤器
$reader = IOFactory::createReader('Xlsx');
$filter = new ChunkReadFilter();
$reader->setReadFilter($filter);

// 先获取文件总行数（避免读取超出范围的空行）
$reader->setReadDataOnly(true);
$tempSpreadsheet = $reader->load($inputFile);
$totalRows = $tempSpreadsheet->getActiveSheet()->getHighestRow();
$tempSpreadsheet->disconnectWorksheets();
unset($tempSpreadsheet);

// 循环分块读取
for ($startRow = 1; $startRow <= $totalRows; $startRow += $chunkSize) {
    // 重置过滤器的行范围
    $filter->setRows($startRow, $chunkSize);
    // 重新加载文件（读取器只会在load时应用过滤规则）
    $spreadsheet = $reader->load($inputFile);
    $worksheet = $spreadsheet->getActiveSheet();

    // 读取当前块的数据
    $currentChunk = [];
    // 处理最后一块的边界，避免超出总行数
    $endRow = min($startRow + $chunkSize - 1, $totalRows);
    foreach ($worksheet->getRowIterator($startRow, $endRow) as $row) {
        $cellIterator = $row->getCellIterator();
        $cellIterator->setIterateOnlyExistingCells(false); // 读取所有单元格（包括空单元格）
        $rowData = [];
        foreach ($cellIterator as $cell) {
            $rowData[] = $cell->getValue();
        }
        $currentChunk[] = $rowData;
    }

    var_dump($currentChunk); // 现在不会出现空块了

    // 及时释放内存，避免大文件导致内存溢出
    $spreadsheet->disconnectWorksheets();
    unset($spreadsheet);
}

关键注意事项： #

• 每次循环必须重新load文件：PHPExcel/PhpSpreadsheet的读取器只会在load时应用过滤规则，不重新加载的话会沿用上次的范围，导致读取空数据。
• 处理文件末尾的剩余行：用min($startRow + $chunkSize - 1, $totalRows)确保最后一块不会超出实际总行数。
• 及时释放内存：每次块处理完后调用disconnectWorksheets()并unset对象，避免PHP内存耗尽。

3. 其他可能的原因 #

如果上述修复后仍有空块，可以排查：

• 文件本身的问题：打开XLSX文件手动检查对应块的行是否确实为空，或者文件是否损坏。
• 依赖版本兼容：确保phpoffice/phpspreadsheet（或旧版phpoffice/phpexcel）的版本兼容PHP7.2和Laravel5.5，建议使用phpspreadsheet1.10.x版本（兼容PHP7.1+）。

内容的提问来源于stack exchange，提问作者web.learner