如何用barryvdh/laravel-snappy分两页打印表格并修复表头丢失问题

以下是几种可行的解决方法：

1. 使用CSS强制表头跨页重复 #

laravel-snappy底层依赖的wkhtmltopdf支持通过CSS属性让表头在每页顶部重复显示，核心是设置thead的display属性：

table {
    width: 100%;
    border-collapse: collapse;
}
thead {
    display: table-header-group; /* 关键：让表头在每一页重复渲染 */
}
th, td {
    border: 1px solid #ddd;
    padding: 8px;
}
/* 可选：防止表格行被跨页拆分，提升排版体验 */
tr {
    page-break-inside: avoid;
}

2. 调整PDF生成配置与页面边距 #

确保生成PDF时的边距设置合理，避免表头被页面顶部裁切：

$pdf = PDF::loadView('你的视图路径', $data)
    ->setOption('margin-top', '12mm') // 给表头留出足够顶部空间
    ->setOption('margin-bottom', '10mm')
    ->setOption('enable-javascript', true); // 部分场景下开启JS可解决渲染问题

3. 确保表格HTML结构正确 #

检查视图中的表格结构，thead必须直接嵌套在table标签内，不要被其他容器（如div）包裹，示例正确结构：

<table>
    <thead>
        <tr>
            <th>序号</th>
            <th>名称</th>
            <th>详情</th>
        </tr>
    </thead>
    <tbody>
        <!-- 循环输出的数据行 -->
        @foreach($items as $item)
            <tr>
                <td>{{ $item->id }}</td>
                <td>{{ $item->name }}</td>
                <td>{{ $item->detail }}</td>
            </tr>
        @endforeach
    </tbody>
</table>

4. 升级wkhtmltopdf版本 #

如果使用的是较旧版本的wkhtmltopdf，可能存在CSS渲染兼容性问题，建议升级到最新稳定版，确保对table-header-group属性的支持正常。

内容的提问来源于stack exchange，提问作者Tiến Hoàng