Laravel使用DomPDF生成PDF时出现连续空白页如何修复

问题根因 #

dompdf 0.6.0版本出现连续空白页、末尾多余空白页，由三个代码逻辑问题共同导致：

• CSS全局给.sheet元素设置了page-break-after: always，会强制在每一个sheet元素后插入分页符，包括最后一个内容页，直接导致末尾生成空白页
• 后端计算每页可容纳行数、卡片尺寸时，没有扣除sheet设置的10mm内边距占用的空间，实际内容总高度超出页面可视范围，触发dompdf自动分页生成空白页
• 代码中定义了$customPaper自定义纸张尺寸，但未调用setPaper()方法将配置应用到dompdf实例，实际渲染使用默认纸张尺寸，和CSS中定义的A4尺寸不匹配，进一步加剧高度计算错位

具体修复步骤 #

• 调整分页CSS规则
  移除最后一页的强制分页属性，同时给根标签加高度限制，避免默认行高、字体行高撑出多余空白：

  @page{margin:0}
  html, body {
      margin: 0;
      padding: 0;
      height: auto;
      line-height: 0;
  }
  .sheet{
      margin:0;
      overflow:hidden;
      position:relative;
      box-sizing:border-box;
      page-break-after:always
  }
  /* 最后一页不强制分页 */
  .sheet:last-child {
      page-break-after: auto;
  }
  /* 原有其余sheet尺寸样式保持不变 */
  .row{
      clear: both;
      display: block;
      overflow: hidden; /* 清除子元素float带来的高度塌陷 */
  }
  

• 修正后端尺寸、页数计算逻辑
  计算可用宽高时扣除内边距占用的空间，行数计算向下取整留1mm左右容错值，避免内容卡满页面边缘触发自动分页：

  // 原有内边距为padding-10mm，上下/左右各占10mm空间
  parent::$data['width'] = 190; // A4宽度210mm - 左右各10mm内边距
  parent::$data['height'] = 277; // A4高度297mm - 上下各10mm内边距，留1mm容错
  $page_with = 190;
  $page_height = 277;
  
  $number_of_items_per_row = parent::$data['number_of_items_per_row'] = intval($request->get('number_of_columns'));
  $img = parent::$data['img'] = asset($request->get('image'));
  
  $data = getimagesize($img);
  $width = $data[0];
  $height = $data[1];
  
  $output_width = parent::$data['output_width'] = intVal($page_with / $number_of_items_per_row);
  $output_height = parent::$data['output_height'] = $height * $output_width / $width;
  // 行数向下取整，避免总高度超出页面
  $rows_count = parent::$data['rows_count'] = floor($page_height / $output_height);
  
  // 其余坐标计算逻辑保持不变
  
  $pdf = Pdf::loadView('cards::admin.card_groups.export.prepaid_card_html', parent::$data);
  // 要么删除未使用的$customPaper定义，要么正确调用setPaper应用自定义尺寸
  // $customPaper = array(0,0,609.4488,1500);
  // $pdf->setPaper($customPaper);
  $pdf->save($file);
  

• 兼容dompdf 0.6.0老版本CSS支持缺陷
  0.6.0版本对:last-child伪类支持不完善，如果改完上述配置最后一页空白仍存在，手动给最后一个sheet加专属类名控制分页：
  模板循环部分修改为：

  @for($p = 0 ; $p < $pages_count; $p++)
      <section class="sheet padding-10mm {{ $p == $pages_count - 1 ? 'last-page' : '' }}">
          {{-- 原有页面内容保持不变 --}}
      </section>
  @endfor
  

  对应增加CSS规则：

  .last-page {
      page-break-after: avoid !important;
  }
  

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