Laravel Dompdf导出含图片PDF超时问题及优化需求

1. 替换远程图片为本地存储 #

远程图片需要Dompdf发起HTTP请求加载，网络延迟是超时核心诱因之一：

• 将图片下载到本地storage/app/public目录，通过Laravel的asset()生成本地URL引用，比如把<img src="https://example.com/big-image.jpg">改成<img src="{{ asset('storage/images/local-image.jpg') }}">
• 禁止直接引用未缓存的远程图片，除非开启Dompdf的远程资源缓存

2. 压缩图片尺寸与质量 #

大尺寸高清图片会大幅增加渲染计算量：

• 使用Intervention Image库压缩图片，调整到适合打印的分辨率（72-150dpi即可）：

use Intervention\Image\ImageManagerStatic as Image;

$compressedImage = Image::make(public_path('images/large-img.jpg'))
    ->resize(800, null, fn($constraint) => $constraint->aspectRatio())
    ->save(public_path('images/compressed-img.jpg'), 70); // 70为质量百分比

• 优先使用WebP格式图片，比JPG/PNG体积小30%-50%

3. 调整Dompdf核心配置 #

先发布配置文件：php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"，再修改config/dompdf.php：

• 禁用不必要的远程资源加载：

'allow_url_fopen' => false, // 仅允许本地图片
'cache' => storage_path('framework/cache/dompdf'), // 开启资源缓存

• 关闭字体子集化（非必要时）：

'font_subsetting' => false,

4. 启用PDF内容缓存 #

对于重复导出的相同内容，直接缓存生成好的PDF文件：

$cacheKey = 'pdf_export_' . auth()->user()->id;
if (Cache::has($cacheKey)) {
    return response(Cache::get($cacheKey))->header('Content-Type', 'application/pdf');
}

// 正常生成PDF逻辑
$pdf = PDF::loadView('pdf.invoice', $data);
$pdfContent = $pdf->output();

Cache::put($cacheKey, $pdfContent, 3600); // 缓存1小时
return $pdf->download('invoice.pdf');

5. 临时调整PHP运行参数（过渡方案） #

优先优化上述项，若仍有瓶颈可临时调整：

// 在控制器生成PDF前设置
ini_set('memory_limit', '256M');
set_time_limit(120); // 仅临时使用，最终要通过优化压到5秒内

6. 简化PDF视图结构 #

• 移除视图中不必要的复杂HTML、CSS（如嵌套过深的div、无用的动画样式）
• 避免在单页PDF中插入超过5张以上的大图片，可拆分多页渲染

内容的提问来源于stack exchange，提问作者JUSTIN CHUA