使用PhpSpreadsheet提取运动监测工具生成的XLSX文件失败

阿华AIGC实验室

2026-5-25

排查PhpSpreadsheet读取XLSX工作表名称异常的问题

先提你代码里的一个冗余点：你重复调用了两次$reader->load($this->filePath)，第二次加载会直接覆盖第一次生成的$spreadsheet对象——虽然这大概率不是导致工作表名称不符合预期的核心原因，但完全没必要保留，先把重复的那行删掉，简化后的代码如下：

$reader = new \PhpOffice\PhpSpreadsheet\Reader\Xlsx();
$reader->setReadDataOnly(true);
$spreadsheet = $reader->load($this->filePath);
$sheetNames = $spreadsheet->getSheetNames();
var_dump($sheetNames);

接下来咱们一步步排查实际问题：

先确认文件本身的工作表数量：手动打开那个运动表现监测工具生成的XLSX文件，仔细看看是不是真的有2个可见（甚至隐藏）的工作表。有些自动生成的文件可能会存在临时工作表、被工具隐藏的表，或者生成时出错实际只有1个表，这是最常见的原因。
验证文件路径的正确性：在load方法调用前加一行var_dump($this->filePath, file_exists($this->filePath));，确认你加载的是目标文件，而不是其他同名旧文件，或者路径写错导致加载了不存在的文件（不过如果文件不存在，load会直接报错，这个可能性稍低，但还是要确认）。
尝试关闭只读数据模式：注释掉$reader->setReadDataOnly(true)再运行试试。某些带有特殊格式的XLSX（比如包含宏、自定义样式或工具专属元数据），只读数据模式可能会让PhpSpreadsheet无法正确解析工作表结构。
检查工作表总数而非仅名称：在打印工作表名称前，先执行var_dump($spreadsheet->getSheetCount());，看看实际识别到的工作表总数是多少。如果总数是1，那说明文件本身确实只有1个表；如果总数是2但名称为空或异常，可能是工作表名称包含特殊字符（比如不可见字符），可以循环遍历工作表打印更详细的信息：
```
foreach ($spreadsheet->getAllSheets() as $sheet) {
    var_dump($sheet->getTitle(), $sheet->getCell('A1')->getValue());
}
```