本地正常部署后报错：Class 'Barryvdh\DomPDF\Facade'未找到

下面是几种可能导致线上服务器出现Class "Barryvdh\DomPDF\Facade" not found错误的原因：

• 依赖包未正确安装或自动加载缓存未更新
  线上部署时如果没执行composer install完整安装依赖，或者安装后没运行composer dump-autoload更新自动加载文件，Laravel就找不到对应的Facade类。重点确认依赖是否装全、自动加载是否更新。

• 配置缓存未刷新
  如果线上服务器执行过php artisan config:cache生成配置缓存，但之后修改了config/app.php里的ServiceProvider或别名配置却没重新生成缓存，Laravel会一直用旧的缓存配置，导致别名不生效、找不到Facade类。这种情况需要运行php artisan config:clear清除缓存，或重新执行php artisan config:cache生成新缓存。

• 大小写敏感问题
  线上服务器大概率是Linux系统，文件名和类名区分大小写，而本地Windows系统不区分。比如你代码里用了Pdf::loadHTML()，但config/app.php里的别名配置的是'PDF' => Barryvdh\DomPDF\Facade::class，或者引入语句里的as PDF和报错行的Pdf大小写不一致，都会触发找不到类的问题。

• 本地与线上包版本不一致
  如果本地和线上的barryvdh/laravel-dompdf包版本不一样，可能存在命名空间变动。比如部分新版本调整了Facade的位置，或旧版本不支持当前的命名空间写法。要确保composer.lock文件同步到线上，执行composer install安装和本地一致的版本。

• 配置文件未同步
  虽然你说本地config/app.php已配置ServiceProvider和别名，但有可能线上服务器的config/app.php没同步更新，导致Laravel没加载对应的服务提供者和别名，自然找不到Facade类。

内容的提问来源于stack exchange，提问作者Raja Tayyab