使用Spout XLSX阅读器插件时出现未定义偏移量错误

嘿，我刚帮你捋了这个Spout的问题，咱们一步步来搞定它：

问题复盘 #

你碰到的情况挺有意思：用Spout读test.xlsx时，第17行的第20列（对应数组索引19）为空就会抛出Notice: Undefined offset: 19，但前16行同一列是空的却完全没问题；只要给这个单元格填点文本，报错就消失了。

为啥会这样？ #

Spout读取Excel时，不会给完全空的列生成单元格对象，但这里前16行没事、第17行报错，大概率是你的Excel文件在第17行的单元格存储上有特殊情况——比如第17行前面的列（索引0-18）有过格式修改，或者单元格被编辑后又清空，但Excel没保留该列的结构标记，导致Spout没为索引19创建空单元格占位；而前16行可能因为曾经有内容，Excel保留了单元格结构，所以Spout生成了对应的空单元格对象。

靠谱的解决方案 #

处理这类索引偏移问题，核心就是别直接硬怼数组索引，先做安全校验，或者换更稳妥的取值方式：

方案1：先检查索引再访问（最简单直接） #

修改你的代码，在访问$cells[19]前先判断这个索引是否存在，不存在就返回null：

include_once(dirname(dirname(__FILE__)) . "/vendors/spout/src/Spout/Autoloader/autoload.php");
use Box\Spout\Reader\Common\Creator\ReaderEntityFactory;

$xlsx = ReaderEntityFactory::createReaderFromFile(dirname(__FILE__) . '/test.xlsx');
$xlsx->open(dirname(__FILE__) . '/test.xlsx');

foreach ($xlsx->getSheetIterator() as $sheet) {
    foreach ($sheet->getRowIterator() as $row) {
        $cells = $row->getCells();
        
        // 安全获取第19列（索引18）的值
        $cell18Value = isset($cells[18]) ? $cells[18]->getValue() : null;
        var_dump($cell18Value);
        
        // 安全获取第20列（索引19）的值，彻底避免Undefined offset报错
        $cell19Value = isset($cells[19]) ? $cells[19]->getValue() : null;
        var_dump($cell19Value);
    }
}

方案2：按列名取值（更直观，适合有表头的Excel） #

如果你的Excel有表头，直接通过列名映射来取值，完全绕开索引问题：

include_once(dirname(dirname(__FILE__)) . "/vendors/spout/src/Spout/Autoloader/autoload.php");
use Box\Spout\Reader\Common\Creator\ReaderEntityFactory;

$xlsx = ReaderEntityFactory::createReaderFromFile(dirname(__FILE__) . '/test.xlsx');
$xlsx->open(dirname(__FILE__) . '/test.xlsx');

foreach ($xlsx->getSheetIterator() as $sheet) {
    $headerMap = [];
    $isFirstRow = true;
    
    foreach ($sheet->getRowIterator() as $row) {
        // 先获取表头与索引的映射
        if ($isFirstRow) {
            foreach ($row->getCells() as $index => $cell) {
                $headerMap[$cell->getValue()] = $index;
            }
            $isFirstRow = false;
            continue;
        }
        
        $cells = $row->getCells();
        // 假设第20列的表头是"你的列名"，替换成实际表头
        $targetColumnIndex = $headerMap['你的列名'] ?? null;
        $targetValue = $targetColumnIndex !== null && isset($cells[$targetColumnIndex]) 
            ? $cells[$targetColumnIndex]->getValue() 
            : null;
        var_dump($targetValue);
    }
}

方案3：统一填充单元格数组（适合需要固定列数的场景） #

如果需要确保所有行的单元格数组长度一致，可以手动填充缺失的索引，把空位置补成null：

include_once(dirname(dirname(__FILE__)) . "/vendors/spout/src/Spout/Autoloader/autoload.php");
use Box\Spout\Reader\Common\Creator\ReaderEntityFactory;

$xlsx = ReaderEntityFactory::createReaderFromFile(dirname(__FILE__) . '/test.xlsx');
$xlsx->open(dirname(__FILE__) . '/test.xlsx');

// 先确定Excel的最大列数，比如你用到第20列就填20
$maxColumnCount = 20;

foreach ($xlsx->getSheetIterator() as $sheet) {
    foreach ($sheet->getRowIterator() as $row) {
        $cells = $row->getCells();
        // 填充数组到指定长度，缺失的位置用null补充
        $filledCells = array_pad($cells, $maxColumnCount, null);
        
        // 现在可以放心访问索引了
        var_dump($filledCells[18] ? $filledCells[18]->getValue() : null);
        var_dump($filledCells[19] ? $filledCells[19]->getValue() : null);
    }
}

小提示 #

如果你好奇为啥Excel文件会有这种差异，可以用Excel的「文件>信息>检查问题>检查文档」功能扫一遍，或者用LibreOffice打开后重新保存，大概率能修复文件内部的单元格结构异常，从根源上避免这种读取不一致的情况。

内容的提问来源于stack exchange，提问作者Giuseppe Lodi Rizzini