Apache POI 3.17生成Word表格时末尾近页脚出现空白页的解决方法

方案1：移除表格后的空白段落 #

Apache POI生成文档时，表格末尾默认会添加空白段落，若该段落刚好触发分页，就会产生空白页。可遍历文档末尾段落，删除无内容的空白段落：

XWPFDocument doc = ...; // 你的文档对象
List<XWPFParagraph> paragraphs = doc.getParagraphs();
int lastIndex = paragraphs.size() - 1;
while (lastIndex >= 0) {
    XWPFParagraph para = paragraphs.get(lastIndex);
    if (para.getText().trim().isEmpty() && para.getRuns().isEmpty()) {
        doc.removeBodyElement(lastIndex);
    } else {
        break;
    }
    lastIndex--;
}

方案2：设置表格允许跨页断行 #

强制表格允许行跨页显示，避免因最后一行接近页脚时被整体推到下一页：

XWPFTable table = ...; // 你的表格对象
CTTablePr tablePr = table.getCTTbl().addNewTblPr();
CTBooleanProperty split = tablePr.addNewSplit();
split.setVal(true);

方案3：计算页面剩余空间，清理多余分页符 #

若上述方法无效，可通过计算页面可用高度，判断表格是否触发不必要的分页，删除多余的分页符：

XWPFDocument doc = ...;
CTSectPr sectPr = doc.getDocument().getBody().getSectPr();
if (sectPr == null) sectPr = doc.getDocument().getBody().addNewSectPr();
CTPageSz pageSz = sectPr.getPgSz();
CTPageMar pageMar = sectPr.getPgMar();

// 计算页面可用高度（单位：twip，1英寸=1440 twip）
float usableHeight = pageSz.getH().floatValue() - pageMar.getTop().floatValue() - pageMar.getBottom().floatValue();

// 计算表格总高度（动态行高按实际字体估算，示例为200 twip/行）
float tableHeight = 0;
for (XWPFTableRow row : table.getRows()) {
    CTTblHeight rowHeight = row.getCtRow().getTrPr().getTrHeight();
    tableHeight += rowHeight != null ? rowHeight.getVal().floatValue() : 200;
}

// 检查并删除无内容的分页符
List<XWPFParagraph> allParas = doc.getParagraphs();
for (int i = allParas.size() - 1; i >= 0; i--) {
    XWPFParagraph para = allParas.get(i);
    if (para.getCTP().getPPr() != null && para.getCTP().getPPr().getPgBr() != null) {
        boolean isEmptyAfter = true;
        for (int j = i + 1; j < allParas.size(); j++) {
            if (!allParas.get(j).getText().trim().isEmpty()) {
                isEmptyAfter = false;
                break;
            }
        }
        if (isEmptyAfter) {
            para.getCTP().getPPr().unsetPgBr();
        }
        break;
    }
}

注意：方案3中动态行高的估算值需根据实际字体大小调整，确保计算更贴合实际情况。

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