结论：安装 composer require barryvdh/laravel-dompdf 后无法直接使用，因依赖 dompdf/dompdf 库，其对 PHP 版本（需 ≥7.4）、GD 扩展、字体路径（storage/fonts/ 需存在且可写）、allow_url_fopen 设置及 HTML 结构高度敏感，常见报错包括 Class 'Dompdf\Dompdf' not found、空白 PDF、中文乱码等。
直接说结论：用 composer require barryvdh/laravel-dompdf 就能装上，但装完不能直接用——它依赖 dompdf/dompdf 底层库，而这个库对 PHP 版本、GD 扩展和字体路径很敏感，多数报错都出在这儿。
为什么 composer require barryvdh/laravel-dompdf 后 PDF 生成失败？
常见错误是 Class 'Dompdf\Dompdf' not found 或生成空白 PDF、中文乱码、字体不显示。这不是 Composer 没装好，而是 barryvdh/laravel-dompdf 只是 Laravel 的封装层，真正干活的是 dompdf/dompdf。它在运行时要加载字体文件、解析 CSS、渲染 HTML，每一步都可能卡住：
-
dompdf/dompdf8.x 要求 PHP >= 7.4，如果你用 PHP 7.2 或 8.3（某些 alpha/beta 版本），会 silently fail - GD 扩展未启用会导致图片不渲染、部分 CSS 不生效，但不会抛异常，只输出空白
- 默认字体目录
storage/fonts/不存在或不可写，中文就变成方块 - Laravel 10+ 默认禁用
allow_url_fopen，而 dompdf 默认尝试从 URL 加载远程字体（比如 Google Fonts），结果超时或 404
怎么让 PDF 中文正常显示？
不是加个 @font-face 就完事。dompdf 对字体支持有限，必须用 TrueType（.ttf）且显式注册。Laravel 下最稳的路径是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把中文字体（如
simhei.ttf或NotoSansCJKsc-Regular.otf）放进storage/fonts/（手动创建该目录并chmod -R 755 storage/fonts） - 运行
php artisan vendor:publish --provider="Barryvdh\DomPDF\ServiceProvider"，生成配置文件config/dompdf.php - 在
config/dompdf.php里改两项：'default_font' => 'simhei'（对应字体文件名，不含扩展）'font_dir' => storage_path('fonts/') - 别在 Blade 模板里用
font-family: "Microsoft YaHei"这类系统字体名——dompdf 不认识，只认你注册进去的名字
生成 PDF 时内存溢出或超时怎么办？
dompdf 是纯 PHP 渲染引擎，遇到复杂表格、大量 inline-style 或嵌套 div，很容易吃光内存。不是 Laravel 配置问题，是 dompdf 自身限制：
- 在
config/dompdf.php里调大：'max_execution_time' => 300（单位秒）'memory_limit' => '512M'（注意这是 dompdf 内部设的，不是 php.ini） - 更有效的是简化 HTML：去掉所有
!important、避免position: fixed/absolute、用<table>替代 flex 布局 - 如果必须用复杂样式，考虑换
spatie/browsershot（基于 Chrome Headless），虽然重，但稳定
真正麻烦的从来不是 composer 那一行命令，而是字体路径权限、PHP 扩展状态、HTML 结构兼容性这三块——它们不出错时不声不响，一出错就是空白 PDF 或满屏方块，还很难定位。
