Dompdf在Laravel中核心限制是不支持flex/grid、JavaScript、外部字体加载失败率高，且易内存溢出；须用barryvdh/laravel-dompdf封装包，中文字体需手动嵌入并配置，HTML须语义化、避免复杂表格与CSS陷阱。
Dompdf 在 Laravel 中生成 PDF 的核心限制是：它不支持现代 CSS 布局（如 flex、grid）、JavaScript、外部字体加载失败率高，且对大表格或长页面容易内存溢出。直接套用浏览器渲染逻辑会失败。
安装 dompdf 及适配 Laravel 的封装包
别直接装原生 dompdf/dompdf，它和 Laravel 不兼容。必须用社区维护的 Laravel 封装版：
- 推荐安装
barryvdh/laravel-dompdf（Laravel 9–10 兼容至 v2.0+） - 执行
composer require barryvdh/laravel-dompdf - Laravel 10+ 无需手动注册服务提供者，但需确认
config/app.php中未禁用自动发现 - 如需自定义配置（比如中文字体），发布配置：
php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"
生成 PDF 时中文乱码/字体缺失的修复方法
Dompdf 默认不支持中文字体，simhei.ttf 或 msyh.ttc 直接引用会报错 Font not found。必须手动嵌入并注册：
- 把中文字体文件（如
simhei.ttf）放到resources/fonts/目录下 - 编辑
config/dompdf.php，在'font' => []中添加："simhei" => base_path('resources/fonts/simhei.ttf') - 在 Blade 模板中用
@font-face声明（注意路径必须为绝对 URL 或 base64）：@font-face { font-family: 'SimHei'; src: url('{{ public_path('fonts/simhei.ttf') }}') format('truetype'); } body { font-family: 'SimHei', sans-serif; } - 调用时显式设置字体：
$pdf->setOption('defaultFont', 'simhei');
用 view() 渲染 HTML 再转 PDF 的典型流程
不要在控制器里拼接 HTML 字符串，必须走 Laravel 视图系统，否则 CSS 和路径解析全乱：
立即学习“前端免费学习笔记（深入）”；
- 新建视图
resources/views/pdf/invoice.blade.php，写纯语义化 HTML（避免position: fixed、transform） - 控制器中用
PDF::loadView()加载视图：use Barryvdh\DomPDF\Facade as PDF; public function exportPdf() { $data = ['order' => Order::find(1)]; $pdf = PDF::loadView('pdf.invoice', $data) ->setOption('isRemoteEnabled', true) // 允许加载远程图片 ->setPaper('a4', 'portrait'); return $pdf->stream('invoice.pdf'); } -
setOption('isRemoteEnabled', true)是关键，否则<img src="https://...>会 404 - 若要下载而非在线预览，把
stream()换成download()
大表格分页/内容截断的应对策略
Dompdf 对 <table> 分页极不友好，默认会在行中间断开。常见症状是 PDF 最后一页只剩半行表格，或直接崩溃：
- 给
<table>加样式：table { page-break-inside: avoid; } tr { page-break-inside: avoid; page-break-after: auto; } - 避免用
colspan/rowspan过多的复杂表，拆成多个小表更稳 - 内存不足报错
Allowed memory size exhausted时，在生成前临时扩大限制：ini_set('memory_limit', '512M'); - 超长内容建议先用
chunk()分批导出，而不是单次渲染万行数据
真正难的不是“怎么调用”，而是 HTML 结构是否足够保守、字体是否真正嵌入成功、表格是否被 dompdf 的分页引擎误判——这些细节不验证，PDF 就会在线上环境随机失败。
