调试PHPSpreadsheet空白屏问题：替换PHPExcel后应用异常

遇到过类似的情况，这种实例化类就直接空白的问题，大概率是触发了PHP致命错误但没正常输出，给你几个实用的调试方向：

• 先确认类是否能被正确加载
  在$spreadsheet = new Spreadsheet();前面加一行：

  var_dump(class_exists('\PhpOffice\PhpSpreadsheet\Spreadsheet')); die();
  

  如果输出bool(false)，说明autoloader没正确引入PHPSpreadsheet的类。检查应用里的vendor/autoload.php是否正确引入，路径是否和实际文件位置匹配——测试脚本可能是直接在项目根目录跑，但应用可能在子目录，导致autoload路径错误。

• 强制开启最高级别的错误捕获
  有时候应用的全局配置会覆盖PHP的错误设置，在出问题的代码块最开头强制设置：

  error_reporting(E_ALL);
  ini_set('display_errors', 1);
  ini_set('log_errors', 1);
  ini_set('error_log', '/tmp/php_phpss_errors.log'); // 指定一个有权限写的日志路径
  

  执行后去看这个日志文件，致命错误（比如类不存在、依赖扩展缺失）通常会在这里留下记录，哪怕前端显示空白。

• 检查PHP环境是否满足PHPSpreadsheet要求
  PHPSpreadsheet对PHP版本（最低7.2，建议7.4+）和扩展有要求，比如xml、zip、gd、mbstring这些都是必需的。对比测试脚本和应用的PHP环境：

  • 用应用的PHP执行路径跑php -m，查看已安装扩展列表
  • 检查PHP版本：php -v
    测试环境满足但应用环境缺扩展的情况很常见，尤其是共享主机或者容器环境。

• 排除应用代码的干扰
  写一个极简的独立脚本放在应用的环境下运行：

  <?php
  require 'vendor/autoload.php'; // 用和应用一样的路径
  error_reporting(E_ALL);
  ini_set('display_errors', 1);
  $spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();
  die('here 2');
  

  如果这个脚本能正常输出，说明是应用里的其他代码导致的冲突：比如残留的PHPExcel类文件没删干净，命名空间冲突；或者应用的自动加载机制（比如自定义的spl_autoload_register）和Composer的autoloader冲突，优先加载了错误的类。

• 检查内存限制
  实例化Spreadsheet可能需要一定内存，应用的memory_limit设置可能比测试脚本低，导致内存不足触发致命错误。可以临时调高：

  ini_set('memory_limit', '256M');
  

内容的提问来源于stack exchange，提问作者11-May