Laravel/maatwebsite/excel导出含&字符时DOM Document加载失败求助

问题根源 #

HTML中的&未正确转义，导致PhpSpreadsheet的HTML阅读器无法解析非规范格式的HTML，抛出DOM加载失败异常。

可行解决方案 #

• 转义视图中的特殊字符
  在控制器或Blade视图里，对包含特殊字符的内容做HTML转义处理：

  // 控制器中预处理数据
  $data = array_map(function($item) {
      $item->content = htmlspecialchars($item->content, ENT_QUOTES);
      return $item;
  }, $originalData);
  
  // 或者Blade视图内直接处理
  {!! htmlspecialchars($item->content, ENT_QUOTES) !!}
  

  此操作会将&转换为&，确保HTML符合DOM解析规范。

• 调整PhpSpreadsheet的HTML解析选项
  在导出类中注册事件，设置HTML阅读器忽略解析警告：

  use Maatwebsite\Excel\Concerns\FromView;
  use Maatwebsite\Excel\Events\BeforeExport;
  use PhpOffice\PhpSpreadsheet\Reader\Html;
  
  class YourExport implements FromView
  {
      protected $data;
  
      public function __construct($data)
      {
          $this->data = $data;
      }
  
      public function view(): \Illuminate\Contracts\View\View
      {
          return view('exports.your-view', ['data' => $this->data]);
      }
  
      public function registerEvents(): array
      {
          return [
              BeforeExport::class => function(BeforeExport $event) {
                  $htmlReader = new Html();
                  $htmlReader->setOptions([
                      'libxml_options' => LIBXML_NOERROR | LIBXML_NOWARNING,
                  ]);
                  $event->writer->setReader($htmlReader);
              },
          ];
      }
  }
  

  通过LIBXML_NOERROR和LIBXML_NOWARNING参数，让解析器忽略非致命的格式错误，避免因特殊字符导致加载失败。

• 清理laravel-excel缓存
  手动删除缓存目录下的旧HTML文件，确保每次导出使用全新生成的内容：

  rm -rf storage/framework/cache/laravel-excel/*
  

  也可在导出逻辑中加入自动清理的代码，比如在控制器调用导出前执行File::cleanDirectory(storage_path('framework/cache/laravel-excel'));。

• 检查并修复视图HTML结构
  确认视图中的HTML标签都正确闭合，避免存在未闭合的<div>、<a>等标签，这些结构问题可能和特殊字符共同触发DOM解析失败。

内容的提问来源于stack exchange，提问作者Mr. Arman