使用barryvdh/laravel-dompdf生成PDF时遇参数类型错误求助

安全阿岳

2026-6-26

解决barryvdh/laravel-dompdf生成PDF时的validateArtifactPath()参数为空错误

问题详情

使用barryvdh/laravel-dompdf生成PDF时触发错误：

Dompdf\Options::validateArtifactPath(): Argument #1 ($path) must be of type string, null given, called in /var/www/html/exhibition/vendor/dompdf/dompdf/src/Options.php on line 1073

修复步骤

这个错误的核心是Dompdf依赖的某个路径配置为null，按以下方式排查修复：

配置文件补全路径
先发布Dompdf配置文件（如果还没生成）：

php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"

打开config/dompdf.php，确保以下项设置为服务器可访问的绝对路径：

'temp_dir' => storage_path('app/dompdf/temp'),
'font_dir' => storage_path('fonts'),
'font_cache' => storage_path('app/dompdf/font-cache'),

确保路径存在且有权限
手动创建路径并设置服务器可写权限：

mkdir -p storage/app/dompdf/temp storage/app/dompdf/font-cache storage/fonts
chmod -R 755 storage/app/dompdf storage/fonts
# 根据服务器运行用户调整，比如Nginx常用www-data
chown -R www-data:www-data storage/app/dompdf storage/fonts

代码内临时指定选项
不想改全局配置的话，生成PDF时直接传入路径配置：

use Barryvdh\DomPDF\Facade\Pdf;

$pdf = Pdf::loadView('你的Blade视图文件名')
    ->setOptions([
        'temp_dir' => storage_path('app/dompdf/temp'),
        'font_dir' => storage_path('fonts'),
        'font_cache' => storage_path('app/dompdf/font-cache'),
    ]);
return $pdf->download('output.pdf');