Spring Boot 3.0中iText HTML转PDF大表格页面适配问题咨询

针对Spring Boot 3.0中使用iText html2pdf 4.0.5转换多列大表格时出现的内容重叠、超出页面问题，提供以下几种可行方案：

一、转换前通过CSS控制页面方向（推荐方案） #

直接在HTML/CSS中指定大表格所在页面为横向，避免后续二次修改PDF的复杂度，具体步骤：

1. 在HTML中给大表格添加专属类名：

<table class="wide-table">
  <!-- 多列表格内容 -->
</table>

2. 内嵌或引入CSS规则，指定该类对应的页面为横向A4：

@page wide-table {
  size: A4 landscape;
  margin: 20mm; /* 保持统一边距 */
}
.wide-table {
  page: wide-table;
  page-break-before: always; /* 让表格单独起一页 */
  page-break-after: always; /* 表格结束后恢复纵向页面 */
}

3. 转换时正常调用HtmlConverter，确保CSS被正确加载：

ConverterProperties converterProperties = new ConverterProperties();
// 若使用外部CSS，可设置BaseUri或通过CssResolver加载
// converterProperties.setBaseUri("classpath:/static/css/");
HtmlConverter.convertToPdf(inputHTML, pdfOutputStream, converterProperties);

二、转换后修改页面方向（适配已有转换流程） #

如果必须先完成全HTML转换再调整页面，可通过iText的PDF解析API识别宽表格所在页面并修改方向：

1. 先将HTML转换为字节流，再二次处理PDF：

// 1. 先完成初始转换
ByteArrayOutputStream tempBaos = new ByteArrayOutputStream();
HtmlConverter.convertToPdf(inputHTML, tempBaos, converterProperties);

// 2. 读取临时PDF并修改页面
PdfReader reader = new PdfReader(new ByteArrayInputStream(tempBaos.toByteArray()));
PdfWriter writer = new PdfWriter(finalPdfOutputStream);
PdfDocument pdfDoc = new PdfDocument(reader, writer);
Document layoutDoc = new Document(pdfDoc);

for (int pageNum = 1; pageNum <= pdfDoc.getNumberOfPages(); pageNum++) {
    PdfPage page = pdfDoc.getPage(pageNum);
    Rectangle portraitSize = PageSize.A4;
    // 遍历页面元素，检查是否存在超出纵向宽度的表格
    boolean hasOverwideTable = false;
    for (IElement elem : layoutDoc.getRenderer().getCurrentArea().getElements()) {
        if (elem instanceof Table table) {
            if (table.getWidth().getValue() > portraitSize.getWidth()) {
                hasOverwideTable = true;
                break;
            }
        }
    }
    if (hasOverwideTable) {
        // 将页面改为横向A4
        page.setPageSize(portraitSize.rotate());
        // 可选：调整页面旋转角度（注意旋转后内容坐标会变化，需按需适配）
        // page.setRotation(90);
    }
}

// 关闭资源
layoutDoc.close();
pdfDoc.close();
reader.close();
writer.close();

注意：此方案需要解析页面布局元素，判断逻辑可能因HTML结构不同需要调整，且修改页面大小后可能存在内容偏移风险。

三、表格适配辅助技巧 #

配合上述方案，可额外添加以下设置优化表格显示：

• 启用表格自动适配页面宽度：

converterProperties.setProperty(HtmlConverterProperties.AUTO_FIT_TABLE_TO_PAGE_WIDTH, "true");

• 给表格单元格添加自动换行：

.wide-table td {
  word-wrap: break-word;
  max-width: 120px; /* 按需设置列宽上限 */
}

• 临时缩小宽表格的字体：

.wide-table {
  font-size: 8pt;
}

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