barryvdh/laravel-dompdf 最稳当，需手动注册服务提供者、禁用自动加载、内联样式与绝对路径资源，避免 Flex/Grid，API 用 download()，调优配置防内存溢出。
用 barryvdh/laravel-dompdf 生成 PDF 最稳当
它不是 Laravel 官方包，但社区验证最久、出问题有迹可循。别碰那些包装了 PhantomJS 或 Puppeteer 的“全自动”方案——本地调试难、部署依赖多、PDF 渲染一致性差。
常见错误现象：Class 'Barryvdh\DomPDF\ServiceProvider' not found，多半是 Composer 自动发现没开，或 Laravel 版本不匹配（Laravel 10+ 需用 barryvdh/laravel-dompdf:^2.0）。
- 安装后务必手动在
config/app.php的providers数组里加Barryvdh\DomPDF\ServiceProvider::class（Laravel 5.5–8.x）；Laravel 9+ 可靠自动发现，但建议检查composer.json中是否启用了"minimum-stability": "stable" -
DOMPDF_ENABLE_AUTOLOAD必须设为false，否则和 Laravel 的自动加载冲突，报Class not found - 字体中文乱码？别改
dompdf-fonts目录，直接在 Blade 模板里用内联@font-face引入你项目里的 .ttf 文件路径，比如url('{{ public_path('fonts/simhei.ttf') }}')
PDF 渲染前必须做这三件事
很多人卡在「页面能打开，PDF 一片空白」或「CSS 全失效」，其实跟渲染流程有关：Dompdf 不执行 JS、不加载外部 CSS 文件、不解析相对路径资源。
- 所有样式必须写成内联
style="..."，或用标签写在里（不能用） - 图片路径必须转成绝对路径：
%20%7D%7D)
asset('images/logo.png') - 避免使用 Flex/Grid 布局——Dompdf 0.8.x 对它们支持极弱，表格布局（
）仍是生成发票/报表最靠谱的选择
PDF::loadView()的参数陷阱这个函数看着简单，但传参稍错就静默失败或输出空白页，尤其在队列或 API 场景下。
典型错误：
PDF::loadView('invoice', $data)->stream()在 API 接口里返回空响应——因为stream()默认发Content-Disposition: inline，某些前端框架（如 Axios）不处理该头，直接丢弃响应体。- API 场景一律用
download('invoice.pdf')，它强制attachment头，前端可捕获 Blob - 想存文件到磁盘？用
save(public_path('pdfs/invoice_'.now()->timestamp.'.pdf'))，注意目录需存在且有写权限 - 传给视图的
$data不能含 Closure、Resource 或未序列化的对象，Dompdf 序列化时会崩，报Serialization of 'Closure' is not allowed
生成慢、内存溢出？先关掉这些
Dompdf 默认行为偏“保守”，大表格或高 DPI 图片极易触发内存超限或超时，不是代码写得烂，是默认配置没调。
错误现象：
Allowed memory size of XXX bytes exhausted或请求卡住 60 秒后 Nginx 504。- 在
config/dompdf.php中把'enable_remote' => false（禁用远程资源加载，防 DNS 卡顿） - 降低渲染精度：
'dpi' => 96（别用 300，打印才需要，屏幕 PDF 96 足够） - 关闭字体缓存：
'enable_font_cache' => false（开发阶段省事，上线再开） - 大表格加
page-break-inside: avoid到上，比让 Dompdf 自动分页更可控 复杂点在于：Dompdf 是单线程、无异步的渲染器，它没法真正“并发”生成多个 PDF。如果业务真要高频生成，得提前预生成+缓存，或者换
spatie/browsershot（基于 Chromium），但那又是另一套环境和权衡了。
- API 场景一律用
