dompdf安装后报class 'pdf' not found，因laravel 5.5+需手动注册服务提供者和门面；中文乱码因缺字体，须复制ttf至storage/fonts并配置路径；内存溢出需调用setpaper()和setoptions()优化；download()失败因误用response()->download()，应直接调用$pdf->download()。
DomPDF 安装后 PDF::loadView() 报 Class 'PDF' not found
这是最常见的起步卡点：Laravel 5.5+ 默认不自动发现包，PDF 门面没注册就直接用，当然找不到。
实操建议：
- 确认已执行
composer require barryvdh/laravel-dompdf - 如果是 Laravel 5.5+，必须手动注册服务提供者：
Barryvdh\DomPDF\ServiceProvider::class到config/app.php的providers数组 - 同时注册门面：
'PDF' => Barryvdh\DomPDF\Facade::class到aliases数组 - Laravel 9+ 用户注意：
barryvdh/laravel-dompdf官方已停止维护，建议改用dompdf/dompdf+ 手动封装，或换spatie/browsershot（需 Node）
中文乱码、字体不显示 —— vendor/dompdf/dompdf/lib/fonts/ 为空
DomPDF 默认不带中文字体，loadView() 渲染含中文的 Blade 模板时，会静默降级为「方块字」或空白，不是报错，所以容易被忽略。
实操建议：
- 别依赖自动字体发现，手动复制一个支持 UTF-8 的 TTF 文件（如
simhei.ttf或NotoSansCJKsc-Regular.otf）到storage/fonts/（不是 vendor 目录） - 在
config/dompdf.php中显式配置：'font_dir' => storage_path('fonts/')和'font_cache' => storage_path('fonts/cache/') - 运行
php artisan dompdf:install（如果包支持）或手动执行php artisan storage:link确保路径可写 - CSS 中必须指定字体：
body { font-family: "simhei", sans-serif; }，仅靠@font-face声明不够
生成大 PDF 内存溢出或超时 —— setPaper() 和 setOption() 关键参数
默认配置按 A4 渲染整页 HTML，但实际业务常要导出长表格或带图片报表，一不留神就 OOM 或 504。
实操建议：
- 调用
loadView()后立刻链式调用：->setPaper('a4', 'portrait')（别用'letter'，中文排版易错行） - 关键性能开关：
->setOptions(['isRemoteEnabled' => true, 'isHtml5ParserEnabled' => true, 'dpi' => 120])，其中isRemoteEnabled允许加载外链 CSS/图片（调试期关掉更安全） - 避免在 Blade 中用
@foreach渲染上千条记录，先在控制器里分页或聚合数据，PDF 只负责展示结构化结果 - 下载前加内存限制检查：
ini_set('memory_limit', '512M');（临时方案，治标；根本解法是拆分导出逻辑）
Laravel 10+ 下 response()->download() 返回 404 或空白文件
不是权限问题，而是 DomPDF 生成的是内存流，不是物理文件路径，直接传给 download() 会失败。
实操建议：
- 必须用
stream()或download()方法本身：return $pdf->download('report.pdf');，不要试图用response()->download($path) - 如果需要自定义响应头（比如加 Content-Disposition），用
stream()+Response封装：return response($pdf->output())->header('Content-Type', 'application/pdf')->header('Content-Disposition', 'attachment; filename="report.pdf"'); - 确保路由没加
middleware('web')外的其他中间件（如 JWT 验证），PDF 生成过程不走 session，部分中间件会中断输出流
flex、grid、position: fixed 基本不可靠，真正要稳定导出报表，得提前把样式降级成 table 布局，或者接受它只是「够用」而非「完美」。 
