Yii2中Dompdf无法渲染内容，生成空白PDF问题排查

你遇到的这个空白PDF问题在Dompdf的使用中挺常见的，结合你的代码和环境，我整理了几个最可能的原因和对应的解决办法：

1. 优先替换为稳定版本的Dompdf #

你当前使用的是dev-master开发分支，这个分支包含未经过充分测试的开发中代码，很可能存在导致渲染失败的bug。建议切换到稳定版：

• 修改composer.json中的依赖为："dompdf/dompdf": "^2.0"
• 执行composer update dompdf/dompdf重新安装稳定版本

2. 检查是否有前置输出干扰 #

Dompdf的stream()方法需要输出纯净的PDF二进制内容，如果在调用它之前有任何输出（包括空格、echo语句、PHP文件开头的空白字符甚至BOM头），都会导致PDF渲染异常变成空白。

• 检查调用PDFHelper::purchase()的代码，确保之前没有任何输出
• 可以在调用stream()前添加输出缓冲区清理：

ob_clean(); // 清空所有待输出的内容
return $dompdf->stream('PDF Document');

3. 确保依赖扩展已启用 #

Dompdf依赖gd和mbstring等PHP扩展，缺少这些扩展可能导致渲染失败。你可以在代码中添加检查：

if (!extension_loaded('gd')) {
    die('错误：GD扩展未启用，Dompdf需要此扩展完成渲染');
}
if (!extension_loaded('mbstring')) {
    die('错误：mbstring扩展未启用，Dompdf需要此扩展处理多字节字符');
}

如果发现缺少扩展，在PHP配置中启用即可。

4. 使用完整的HTML文档结构 #

虽然你用的<p>Test</p>很简单，但Dompdf对不完整的HTML文档兼容性较差，建议使用完整的HTML结构包裹内容：

$dompdf->loadHtml('
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
</head>
<body>
    <p>Test</p>
</body>
</html>
');

5. 开启调试模式查看具体错误 #

如果以上方法都没解决问题，可以开启Dompdf的调试模式，获取详细的错误信息：

$dompdf = new Dompdf();
$dompdf->set_option('isDebuggingEnabled', true);
$dompdf->loadHtml('<p>Test</p>');
return $dompdf->stream('PDF Document');

调试模式会输出渲染过程中的具体错误，帮你精准定位问题。

内容的提问来源于stack exchange，提问作者Sasha