Java使用Flying Saucer转PDF时长表格分页表头缺失问题求助

直接给出可行的修复方案：

1. 调整CSS样式（核心修复） #

Flying Saucer的CSS渲染逻辑和浏览器存在差异，需要补充关键属性触发表头重复：

table {
  width: 100%; /* 必须明确宽度，否则无法触发表头重复逻辑 */
  border-collapse: collapse; /* 合并边框是Flying Saucer识别表头的前提 */
  page-break-inside: auto;
}

thead {
  display: table-header-group; /* 标记为表头组，核心属性 */
}

tbody {
  display: table-row-group;
}

tr {
  page-break-inside: avoid; /* 避免单行跨页，优化分页体验 */
}

你之前的CSS缺失了width:100%和border-collapse:collapse，这两个是Flying Saucer正确识别并重复表头的必要条件。

2. 确保HTML表格结构合规 #

检查Thymeleaf生成的HTML，保证thead是table的直接子元素，无嵌套容器，示例结构：

<table>
  <thead>
    <tr>
      <th>列1</th>
      <th>列2</th>
      <!-- 其他表头列 -->
    </tr>
  </thead>
  <tbody>
    <!-- 动态数据行 -->
    <tr th:each="item : ${dataList}">
      <td th:text="${item.field1}"></td>
      <td th:text="${item.field2}"></td>
    </tr>
  </tbody>
</table>

3. 优化渲染配置 #

在渲染前开启打印模式，让Flying Saucer适配打印场景：

private byte[] generatePdfFromHtml(String html) throws IOException, DocumentException {
        ByteArrayOutputStream byteArrayOutputStream = new ByteArrayOutputStream();
        ITextRenderer renderer = new ITextRenderer();
        // 新增：开启打印模式，增强分页和表头重复支持
        renderer.getSharedContext().setPrint(true);
        renderer.setDocumentFromString(html);
        renderer.layout();
        renderer.createPDF(byteArrayOutputStream);
        return  byteArrayOutputStream.toByteArray();
    }

4. 检查依赖版本 #

建议使用Flying Saucer 9.1.x以上版本，同时确保依赖的iText版本与之兼容，避免旧版本的已知bug。

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