Laravel 8配置dompdf后仍提示“Undefined type PDF”问题排查

• 检查别名配置位置
  确保'PDF' => Barryvdh\DomPDF\Facade::class是添加在config/app.php文件的aliases数组内，示例：

  'aliases' => [
      // ... 其他已存在的别名
      'PDF' => Barryvdh\DomPDF\Facade::class,
  ],
  

• 清除配置缓存
  如果之前执行过php artisan config:cache，修改配置后需要更新缓存，执行命令：

  php artisan config:clear
  php artisan config:cache
  

  或者直接清除缓存：php artisan config:clear

• 刷新IDE缓存
  多数IDE（如PHPStorm、VSCode）会缓存类信息，导致别名无法被识别：

  • PHPStorm：点击File -> Invalidate Caches...，选择清除缓存并重启IDE
  • VSCode：执行PHP: Reload Workspace命令

• 替换为完整命名空间导入
  直接使用Facade的完整命名空间导入，替代别名导入：

  use Barryvdh\DomPDF\Facade as PDF;
  

  代码中依然可以用PDF::loadHTML($html)调用方法。

• 确认服务提供者已注册
  对于Laravel 5.4及以下版本，需手动在config/app.php的providers数组中添加服务提供者：

  'providers' => [
      // ... 其他已存在的服务提供者
      Barryvdh\DomPDF\ServiceProvider::class,
  ],
  

  Laravel 5.5+支持自动发现，若自动发现失效也可手动添加。

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