Laravel 中用 dompdf 或 snappy 生成 PDF 可行但易遇中文乱码、字体失效、分页错位等问题；dompdf 需手动注册中文字体并禁用 @font-face，snappy 需确保 wkhtmltopdf 正确安装与权限；均推荐用 CLI 调试。
直接用 dompdf 或 snappy 生成 PDF 在 Laravel 中可行，但实际落地时容易卡在字体、中文渲染、分页和样式错位上——尤其是 dompdf 对 CSS 支持弱，snappy 依赖系统级 wkhtmltopdf 二进制，部署环境稍有差异就报错。
dompdf 中文乱码、字体不生效怎么办
dompdf 默认不带中文字体，mbstring 和 php-gd 扩展必须启用，否则连基础 UTF-8 解析都会失败。核心是把字体文件（如 Noto Sans CJK SC）复制到 vendor/dompdf/dompdf/lib/fonts/，再通过 Dompdf\Options 显式注册：
$options = new Options();
$options->set('defaultFont', 'sans-serif');
$options->set('fontDir', public_path('fonts')); // 指向你放 .ttf 的目录
$options->set('fontCache', storage_path('fonts'));
- 不要用
@font-face在 CSS 里加载远程字体，dompdf 不支持 - HTML 中避免用
，优先用 class + 内联style="font-family: 'Noto Sans CJK SC'" - 表格内容超长时 dompdf 容易崩溃，加
table { page-break-inside: avoid; }强制不分页
snappy 生成空白页或报 exit code 1 错误
这是 wkhtmltopdf 二进制没跑起来的典型表现。Laravel 的 barryvdh/laravel-snappy 包只是封装，真正执行的是系统命令。先确认：
- 运行
wkhtmltopdf --version能否返回版本号（Ubuntu/Debian 推荐用apt install wkhtmltopdf，别用 npm 安装的轻量版） - PHP 进程是否有权限读取临时 HTML 文件（
storage/framework/views/xxx.blade.php） - PDF 生成前确保 Blade 模板里没有 PHP 错误或未定义变量，snappy 不会抛出 PHP 异常，只会静默失败
调试时加 ->setOption('quiet', false) 和 ->setOption('log-level', 3)，错误会输出到日志。
blade 模板里怎么控制分页和页眉页脚
dompdf 和 snappy 都支持 CSS Paged Media，但兼容性不同。关键写法：
@page {
margin: 2cm;
@top-center {
content: "第 " counter(page) " 页";
}
}
.page-break { page-break-before: always; }
- dompdf 只支持
@page和page-break-before/after，不支持break-inside: avoid - snappy（wkhtmltopdf）支持更多，但必须加
->setOption('enable-javascript', true)才能触发动态页眉 - 页眉页脚内容建议用绝对定位 +
position: fixed，比@top-center更可控
最麻烦的其实是开发机和生产环境字体路径不一致、wkhtmltopdf 版本差异、以及 PDF 渲染时无法 debug 的黑盒感——建议把 PDF 生成逻辑单独抽成 Artisan 命令，在 CLI 下运行并查看完整错误输出，比在 HTTP 请求里试错快得多。
