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/，再通过 DompdfOptions 显式注册：

$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 请求里试错快得多。