iText 5.5.13页面顶部无法添加间距问题求助

问题原因 #

iText 5.5.13对PdfPCell的高度计算逻辑做了调整：空单元格（无内容）的默认高度为0，即使设置setPaddingTop()也不会产生实际占位空间——因为padding是基于单元格内容生效的，没有内容时padding无法撑开单元格高度，这和2.0.7的行为完全不同。

解决方案 #

以下几种方法都能解决问题，按需选择：

方法1：给空单元格设置最小高度（贴合原代码逻辑）

直接让单元格强制占据指定高度，无需依赖padding：

protected Element createTopPadding(int size) {
    PdfPTable padding = new PdfPTable(1);
    // 清除表格默认的前后间距，避免额外空白
    padding.setSpacingBefore(0);
    padding.setSpacingAfter(0);
    padding.setWidthPercentage(100);

    PdfPCell cell = new PdfPCell();
    cell.setBorderWidth(0);
    // 设置单元格最小高度为需要的间距值
    cell.setMinimumHeight(size);

    padding.addCell(cell);
    return padding;
}

方法2：给单元格添加空白内容，配合padding生效

给空单元格加一个空白Chunk，让padding能撑开高度：

protected Element createTopPadding(int size) {
    PdfPTable padding = new PdfPTable(1);
    padding.setSpacingBefore(0);
    padding.setSpacingAfter(0);
    padding.setWidthPercentage(100);

    PdfPCell cell = new PdfPCell();
    cell.setBorderWidth(0);
    cell.setPaddingTop(size);
    // 添加空白内容，让单元格有高度支撑
    cell.addElement(new Paragraph(new Chunk(" ")));

    padding.addCell(cell);
    return padding;
}

方法3：改用Paragraph实现间距（更简洁的方案）

放弃用表格，直接用Paragraph的间距属性实现顶部空白，代码更轻量化：

protected Element createTopPadding(int size) {
    Paragraph paddingPara = new Paragraph();
    // 设置段落前的空白间距
    paddingPara.setSpacingBefore(size);
    return paddingPara;
}

验证说明 #

以上三种方法都能在iText 5.5.13中生成稳定的顶部间距，避免文本重叠问题。优先推荐方法1或3，逻辑更清晰且性能更好。

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