Laravel PDF包点击生成按钮后出现150+空白页及少量文本问题

问题现象 #

点击PDF按钮后生成的文件包含150多页空白页，仅夹杂少量文本。

相关代码 #

控制器代码 #

$data      = self::getOrderSheetReport($param);
$pdf       = \PDF::loadView('bPack.report.sales.orderSheet.report', $data);
$file_name = 'orderSheet-'.date('Y-m-d').'.pdf';
return $pdf->stream($file_name);

Blade页面代码 #

<a href="{{$pdf_url}}" class="btn btn-default" target="_blank">PDF</a>

排查与解决方向 #

• 检查视图模板：查看bPack.report.sales.orderSheet.report模板，确认是否存在未闭合的HTML标签、大量隐藏空白内容，或是宽度超出PDF页面范围的元素（比如过宽的表格），这类问题会触发PDF引擎自动生成大量空白分页。
• 排查CSS样式：避免使用position: absolute等易导致内容错位溢出的样式；检查是否在循环渲染的元素上错误添加了page-break-after: always强制分页规则，导致每条数据都触发新分页。
• 校验数据内容：确认getOrderSheetReport($param)返回的数据是否包含大量空值或空数组，导致模板循环生成大量空DOM元素，被PDF引擎渲染为空白页。
• 检查PDF包配置：查看所用PDF包（如dompdf、laravel-dompdf）的页面尺寸、边距配置，若页面高度设置过小或边距过大，会迫使内容频繁分页产生空白页。

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