根本原因是dompdf 2.0+要求PHP≥8.0且弃用旧版，需确认PHP版本、指定兼容版本如^1.4，正确引入autoload、使用use Dompdf\Dompdf、配置setBasePath()和字体注册，禁用远程资源并调大内存限制。
Composer 安装 dompdf 时提示 dompdf/dompdf 找不到或版本冲突
根本原因不是库不存在，而是 dompdf/dompdf 自 2.0 起已废弃官方维护，现在主推的是 dompdf/dompdf 的“兼容层”——实际应安装 dompdf/dompdf 的最新稳定分支（v2+），但 Composer 默认可能拉取旧版或 dev 分支。更常见的是你本地 PHP 版本低于 8.0，而新版 dompdf 要求 PHP ≥ 8.0。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 先确认 PHP 版本：
php -v；若低于 8.0，要么升级 PHP，要么强制指定旧版：composer require dompdf/dompdf:^1.4 - 不要用
composer require dompdf/dompdf:dev-main，dev 分支不稳定，容易报Class 'Dompdf\Dompdf' not found - 安装后检查
vendor/autoload.php是否被正确引入——漏掉这步，后面实例化必报错
new Dompdf() 报错 Class 'Dompdf\Dompdf' not found
这不是类名写错，而是自动加载没生效，或者命名空间没对上。v2+ 版本的入口类路径和 v1 不同，且默认不启用字体/缓存目录，也会间接导致初始化失败。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 确保用了正确的命名空间：
use Dompdf\Dompdf;（不是DOMPDF或dompdf\Dompdf） - 实例化前必须设置选项，尤其
setBasePath()和setOptions()，否则部分环境会静默失败：$dompdf = new Dompdf(['enable_remote' => true, 'log_output_file' => '/tmp/dompdf.log']);
- 如果项目用了 PSR-4 自动加载规则，检查
composer.json中是否误删了"autoload": {"psr-4": ...}段落
HTML 转 PDF 后中文乱码或字体缺失
dompdf 默认只认英文，不自带中文字体，也不自动解析 @font-face。所谓“支持中文”只是指能渲染，前提是字体文件存在且路径可读。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 把中文字体（如
simsum.ttc或NotoSansCJKsc-Regular.otf）放进项目目录，比如fonts/子目录 - 在代码里显式注册字体：
$dompdf->getFontMetrics()->registerFont(['family' => 'SimSun', 'style' => 'normal', 'path' => __DIR__ . '/fonts/simsum.ttc']);
- CSS 中必须用注册的 family 名：
body { font-family: 'SimSun'; }；用font-family: 'Microsoft YaHei'这种系统字体名无效 - 避免用
font-weight: bold却没注册对应粗体文件，否则 dompdf 会跳过整段样式
生成大 HTML 页面时内存溢出或超时
dompdf 是纯 PHP 渲染引擎，不做流式处理。一个 5MB 的 HTML 可能吃掉 500MB 内存，且默认执行时间限制（30s）很容易触发。
实操建议：
立即学习“前端免费学习笔记（深入）”；
- 调大 PHP 限制：
ini_set('memory_limit', '512M');和set_time_limit(300);（放在new Dompdf()前） - 禁用远程资源加载（除非真需要）：
['enable_remote' => false]，否则每张图片都会发起 HTTP 请求，拖慢并增加失败率 - 简化 HTML：移除无用
script、iframe、内联 base64 图片；表格尽量用table-layout: fixed避免重排 - 别用
$dompdf->stream()直接输出大文件，改用$dompdf->output()+file_put_contents()写磁盘，再由 Nginx/CDN 提供下载
真正卡住的地方往往不是语法或安装，而是字体路径权限不对、PHP 内存设太低、或者 HTML 里藏了个 10MB 的 data:image/svg+xml —— 这些细节不打日志根本看不出来。
