PhpOffice\PhpSpreadsheet读取Excel报错：结构化引用无法定位Table7

错误提示：Top Sheet!E102 -> Top Sheet!E15 -> Table Table7 for Structured Reference cannot be located

这个错误源于Excel文件中E15单元格使用了指向Table7的结构化引用，但PhpSpreadsheet无法找到对应的表格对象——即便你设置了setReadDataOnly(true)，引擎在解析单元格依赖时仍会触发该异常。以下是几种可行的解决方法：

方法1：禁用计算引擎的异常抛出 #

在加载Excel文件后，修改计算引擎配置，使其遇到引用错误时不抛出异常：

$file = $request->file;

$readerExtension = ucfirst($file->getClientOriginalExtension());
$reader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader($readerExtension);
$reader->setReadDataOnly(true);
$spreadsheet = $reader->load($request->file('file'));

// 添加此行禁用计算异常
\PhpOffice\PhpSpreadsheet\Calculation\Calculation::getInstance($spreadsheet)->setThrowExceptions(false);

$allSheetsArray = $spreadsheet->getSheetNames();
$import = $spreadsheet->getSheetByName('Top Sheet');
$cell = $import->getCell('E102');
$cellDataType = $cell->getDataType();
dd($cell);

设置后即使找不到Table7，PhpSpreadsheet只会返回错误标识（如#REF!），但不会中断程序，你仍能读取到单元格的缓存计算值。

方法2：直接读取单元格缓存值数组 #

跳过单个单元格对象的获取逻辑，直接将工作表转为二维数组，彻底规避公式解析：

$file = $request->file;

$readerExtension = ucfirst($file->getClientOriginalExtension());
$reader = \PhpOffice\PhpSpreadsheet\IOFactory::createReader($readerExtension);
$reader->setReadDataOnly(true);
$spreadsheet = $reader->load($request->file('file'));

$import = $spreadsheet->getSheetByName('Top Sheet');
// 转为二维数组，行/列均从0开始索引
$sheetData = $import->toArray();
// E102对应第101行（原行号102-1）、第4列（E列是第5列，5-1）
$cellValue = $sheetData[101][4];
dd($cellValue);

这种方式直接读取Excel中已计算好的缓存值，不会触发任何公式解析操作。

方法3：修复Excel文件本身的引用问题 #

打开出错的Excel文件，定位到Top Sheet!E15单元格：

• 如果Table7确实不存在，删除该结构化引用，替换为有效单元格引用
• 如果Table7被误删除，重新创建对应表格并修正引用

修复后再用PhpSpreadsheet读取，即可消除该错误。

内容的提问来源于stack exchange，提问作者Ashok