使用DomPDF生成PDF时页数与Chrome导出不一致的问题

以下是几个针对性的排查和解决方向：

• 统一边距配置
  DomPDF的默认边距通常比Chrome打印的默认边距大，这会导致相同内容在DomPDF中因可用空间不足而分页。可以手动设置与Chrome一致的边距：

$dompdf->setPaper('A4', 'portrait');
// 匹配Chrome默认打印边距（约10mm）
$dompdf->setMargins(10, 10, 10, 10);

• 排查溢出的HTML元素
  Chrome的打印引擎对溢出元素的处理更灵活，而DomPDF严格遵循CSS规则。检查以下几点：

  • 移除元素的固定宽度设置，比如将width: 220mm这类超出A4宽度的样式改为max-width: 100%
  • 给表格添加table-layout: fixed样式，避免列宽自动撑开超出页面
  • 用box-sizing: border-box统一元素的盒模型，防止内边距、边框额外占用宽度

• 添加CSS分页控制
  在HTML的样式中添加打印专用的CSS规则，强制内容在一页内：

@media print {
  body {
    margin: 0;
    padding: 0;
  }
  .invoice-wrapper { /* 替换为你的内容容器类名 */
    page-break-inside: avoid;
    page-break-after: avoid;
    width: 100%;
  }
}

• 启用DomPDF调试模式
  开启调试模式可以查看渲染时的元素尺寸和分页触发原因，帮助定位问题：

$options->set('debug', true);
$options->set('logOutputFile', 'dompdf_debug.log'); // 将日志输出到文件

• 清理隐性空白内容
  HTML中存在的隐性换行、空白元素可能在DomPDF中被渲染为额外高度，导致分页。可以通过CSS重置全局样式：

* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

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