Yii2框架使用Dompdf生成PDF为空且报HeadersAlreadySentException错误如何解决

云上老周

2026-10-6

错误根因

该HeadersAlreadySentException报错源于Dompdf与Yii2框架的响应机制冲突：Dompdf默认执行渲染后会直接发送HTTP头、输出PDF内容，而Yii2会统一管理所有响应头和输出内容，Dompdf提前发送头信息后，Yii2后续再尝试发送头就会触发该异常，最终返回空白PDF。

修复方案

修改控制器actionPdf代码如下，将PDF输出完全交由Yii2响应层处理：

use Dompdf\Dompdf;
use yii\web\Response;

// ...其他代码

function actionPdf() {
    // 关闭布局渲染，避免多余输出
    $this->layout = false;
    // 设置Yii响应格式为原始二进制
    \Yii::$app->response->format = Response::FORMAT_RAW;

    $dompdf = new DOMPDF();
    $dompdf->loadHtml('<h1>hello world</h1>');
    $dompdf->setPaper('A4', 'landscape');
    $dompdf->render();

    // 提取PDF二进制内容，不直接输出
    $pdfContent = $dompdf->output();

    // 手动配置Yii响应头
    $response = \Yii::$app->response;
    $response->headers->removeAll();
    $response->headers->set('Content-Type', 'application/pdf');
    // 预览用inline，需要下载则替换为attachment
    $response->headers->set('Content-Disposition', 'inline; filename="sample.pdf"');
    $response->headers->set('Content-Length', (string)strlen($pdfContent));

    // 赋值PDF内容到响应体
    $response->content = $pdfContent;

    // 直接返回响应终止后续处理
    return $response;
}