Dompdf生成PDF时表格padding/margin分页后失效问题求解

这是dompdf分页渲染逻辑的固有特性导致的：给普通块级元素设置的padding-top/margin-top只会在元素首次渲染的第一页顶部生效，当表格内容过长触发自动分页时，接续渲染的表格内容不会重复应用顶部边距，因此会直接顶到页面顶部，被position:fixed定位的固定表头遮挡。

方案1：使用页面级边距+原生页眉绑定（最稳定，优先推荐） #

不要依赖position:fixed+表格内边距的组合实现固定表头，改用dompdf原生支持的页面配置+页眉注入逻辑，从渲染层面预留表头空间，从根源避免跨页遮挡：

1. 首先通过@page规则给所有页面顶部预留足够的表头占位空间，移除原有.my-table上的padding-top: 275px样式：

@page {
  margin-top: 275px; /* 高度和之前给表格设置的顶部避让距离一致 */
  margin-bottom: 25px;
  /* 左右页边距按业务需求设置即可 */
}

2. 去掉.fixed-header上的position: fixed属性，在PHP渲染逻辑中把表头注册为全局页眉，dompdf会自动在每一页的顶部预留区域渲染表头，正文区域会自动和表头保持距离，不会出现遮挡：

// dompdf实例化、加载HTML完成后执行
$dompdf->render();
$canvas = $dompdf->getCanvas();
$totalPages = $canvas->get_page_count();

// 抓取固定表头的DOM内容
$headerNode = $dompdf->getDom()->find('.fixed-header')[0];
$headerContent = $dompdf->outputHtml($headerNode);

// 给所有页面注入页眉
for ($pageNum = 1; $pageNum <= $totalPages; $pageNum++) {
    $canvas->page_script(function($pdf, $fontMetrics) use ($pageNum, $headerContent) {
        $pdf->set_page($pageNum);
        // 把表头渲染到每页顶部的预留区域，坐标可根据实际布局调整
        $pdf->writeHTML($headerContent, 0, 80, $pdf->get_width(), 80);
    });
}

该方案完全匹配dompdf的渲染规则，是官方文档推荐的跨页固定页眉实现方式，不会出现边距失效问题。

方案2：利用表格thead的跨页渲染特性（改动最小，适配现有逻辑） #

如果不想调整现有固定表头的实现逻辑，可以利用dompdf的渲染规则：长表格跨页时，<thead>标签内的内容会在每一页的表格开头自动重复渲染，用这个特性做顶部占位即可：

1. 移除.my-table上的padding-top: 275px样式
2. 在业务表格内部增加一个无内容、无样式的占位thead，高度设置为需要的避让距离：

<table class="my-table">
  <!-- 占位thead，跨页时会在每页表格顶部自动渲染 -->
  <thead>
    <tr>
      <td style="height: 275px; border: none; padding: 0; margin: 0;"></td>
    </tr>
  </thead>
  <!-- 原有业务表格内容 -->
  <tbody>
    <!-- 业务表格行内容 -->
  </tbody>
</table>

3. 保留原有.fixed-header的fixed定位样式即可，每一页的表格开头都会自动渲染275px高的空白占位，不会被固定表头遮挡。

方案3：手动拆分长表格（兼容所有dompdf版本） #

如果使用的是0.8.x及更早的低版本dompdf，上述两个方案存在兼容问题，可以在PHP侧提前处理表格内容：根据单页可容纳的表格行数，把长表格拆分为多个独立的短表格，每个短表格都保留padding-top: 275px样式。由于每个短表格都是独立的块级元素，分页时顶部边距会正常生效。
注意拆分时不要把单行内容拆到两个表格中，避免行内内容被截断。

• 0.8.x及更早版本的dompdf对position:fixed元素的层级渲染存在已知bug，固定定位元素会默认覆盖同位置的普通流内容，不要依赖外层容器的padding/margin实现跨页避让
• 跨页长表格外层容器的边距、内边距只会在容器首次出现的第一页生效，只有页面级边距、表格thead这类支持跨页重复渲染的元素，才能在每一页生成稳定的顶部避让空间

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