如何使用PHPSpreadsheet写入现有电子表格并解决Xlsx构造参数null报错

该错误核心是传入Xlsx构造函数的参数不是预期的PhpOffice\PhpSpreadsheet\Spreadsheet类实例，而是null值，通常由两个原因导致：

• 电子表格加载失败：目标xlsx文件路径填写错误、运行PHP的进程无文件读取权限、文件本身格式损坏，都会导致IOFactory::load()执行失败，最终$spreadsheet变量为null。
• 命名空间引入缺失：代码中直接实例化Xlsx类，但没有提前引入该类对应的命名空间，PHP无法识别Xlsx类，触发的异常栈会将传入参数识别为null。

按以下步骤修改代码即可解决问题：

1. 补全类的命名空间引用，二选一即可：
   • 方案1：在PHP文件顶部添加命名空间引入声明

     use PhpOffice\PhpSpreadsheet\IOFactory;
     use PhpOffice\PhpSpreadsheet\Writer\Xlsx;
     

   • 方案2：实例化类时写全命名空间路径
     加载代码改为$spreadsheet = \PhpOffice\PhpSpreadsheet\IOFactory::load("yourspreadsheet.xlsx");
     实例化写入器代码改为$writer = new \PhpOffice\PhpSpreadsheet\Writer\Xlsx($spreadsheet);
2. 增加文件读写校验逻辑，避免因文件权限/路径问题导致加载失败

完整可运行的参考代码如下：

<?php
use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Writer\Xlsx;

$filePath = "yourspreadsheet.xlsx";
// 校验读取权限
if (!file_exists($filePath) || !is_readable($filePath)) {
    die("表格文件不存在或无读取权限");
}
// 加载表格并校验结果
$spreadsheet = IOFactory::load($filePath);
if (!$spreadsheet instanceof \PhpOffice\PhpSpreadsheet\Spreadsheet) {
    die("表格加载失败，请检查文件是否损坏");
}
// 修改单元格内容
$sheet = $spreadsheet->getActiveSheet();
$sheet->setCellValue('A1', 'New Value');
// 校验写入权限
$saveDir = dirname($filePath);
if (!is_writable($saveDir) || (file_exists($filePath) && !is_writable($filePath))) {
    die("目录或文件无写入权限，无法保存");
}
// 保存文件
$writer = new Xlsx($spreadsheet);
$writer->save($filePath);

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