使用Apache POI生成Word表格时出现莫名间距的问题排查

问题成因 #

你遇到的间距问题主要来自三个容易被忽略的细节：

1. 段落默认间距未彻底清除：即使调用了setSpacingBefore(0)和setSpacingAfter(0)，Apache POI的段落API可能未完全覆盖OOXML底层的间距规则，仍会残留微小间距
2. 单元格边距的OOXML底层设置未生效：table.setCellMargins(0,0,0,0)有时无法同步到每个单元格的CTTcPr配置，导致单元格内部仍有默认边距
3. 表格整体缩进未清零：Word表格默认存在微小的左侧缩进，会让表格和页眉边缘产生间距

解决代码及修改说明 #

以下是修正后的代码，关键修改处已标注：

int TWIPS_PER_INCH = 1440;

XWPFHeader header = doc.createHeader(HeaderFooterType.DEFAULT);
XWPFTable table = header.createTable(1, 2);
//table.removeBorders();
table.setWidth("100%");
table.setCellMargins(0, 0, 0, 0);

// 新增：设置表格整体缩进为0，消除表格与页眉边缘的间距
table.getCTTbl().getTblPr().addNewTblInd().setW(BigInteger.valueOf(0));

/*
 * Create CTTblGrid for this table with widths of the 2 columns. 
 * Necessary for Libreoffice/Openoffice to accept the column widths.
 */
table.getCTTbl().addNewTblGrid().addNewGridCol().setW(BigInteger.valueOf(3 * TWIPS_PER_INCH));
table.getCTTbl().getTblGrid().addNewGridCol().setW(BigInteger.valueOf(3 * TWIPS_PER_INCH));

/*
 * Left-Hand Cell
 */
XWPFTableRow tableRow = table.getRow(0);
XWPFTableCell cell = tableRow.getCell(0); 

cell.setVerticalAlignment(XWPFTableCell.XWPFVertAlign.BOTTOM);
cell.setWidth("50%");

// 新增：直接设置单元格CT层面的边距，确保彻底清零
CTTcPr cttcPr = cell.getCTTc().getTcPr();
if (cttcPr == null) cttcPr = cell.getCTTc().addNewTcPr();
CTTcMar tcMar = cttcPr.addNewTcMar();
tcMar.setLeft(BigInteger.valueOf(0));
tcMar.setRight(BigInteger.valueOf(0));
tcMar.setTop(BigInteger.valueOf(0));
tcMar.setBottom(BigInteger.valueOf(0));

XWPFParagraph paragraph = cell.getParagraphArray(0);
if (paragraph == null) paragraph = cell.addParagraph();

paragraph.setAlignment(ParagraphAlignment.LEFT);
paragraph.setSpacingBefore(0);
paragraph.setSpacingAfter(0);
paragraph.setFirstLineIndent(0);
paragraph.setIndentationLeft(0);

// 新增：彻底清除段落底层间距设置
CTPPr ctppr = paragraph.getCTP().getPPr();
if (ctppr == null) ctppr = paragraph.getCTP().addNewPPr();
CTSpacing spacing = ctppr.addNewSpacing();
spacing.setBefore(BigInteger.valueOf(0));
spacing.setAfter(BigInteger.valueOf(0));
spacing.setLine(BigInteger.valueOf(0));
spacing.setLineRule(STLineRule.EXACT);

// 修正：移除重复创建的Run，避免空Run占位
XWPFRun run = paragraph.createRun();
run.setFontFamily("Helvetica");
run.setFontSize(18);
run.setText("Section Title");

/*
 * Right-Hand Cell
 */
cell = tableRow.getCell(1); 
cell.setWidth("50%");
cell.setVerticalAlignment(XWPFTableCell.XWPFVertAlign.BOTTOM);

// 新增：同样设置右侧单元格的CT层面边距
cttcPr = cell.getCTTc().getTcPr();
if (cttcPr == null) cttcPr = cell.getCTTc().addNewTcPr();
tcMar = cttcPr.addNewTcMar();
tcMar.setLeft(BigInteger.valueOf(0));
tcMar.setRight(BigInteger.valueOf(0));
tcMar.setTop(BigInteger.valueOf(0));
tcMar.setBottom(BigInteger.valueOf(0));

paragraph = cell.getParagraphArray(0);
if (paragraph == null) paragraph = cell.addParagraph();

paragraph.setAlignment(ParagraphAlignment.RIGHT);
paragraph.setSpacingBefore(0);
paragraph.setSpacingAfter(0);
paragraph.setFirstLineIndent(0);
paragraph.setIndentationRight(0);

// 新增：彻底清除右侧段落底层间距设置
ctppr = paragraph.getCTP().getPPr();
if (ctppr == null) ctppr = paragraph.getCTP().addNewPPr();
spacing = ctppr.addNewSpacing();
spacing.setBefore(BigInteger.valueOf(0));
spacing.setAfter(BigInteger.valueOf(0));
spacing.setLine(BigInteger.valueOf(0));
spacing.setLineRule(STLineRule.EXACT);

// 修正：移除重复创建的Run
run = paragraph.createRun();
run.setFontFamily("Helvetica");
run.setFontSize(15);
run.setText("Sub-Title");

// 原日志代码保留
logger.log( String.format("BOTTOM BORDER SPACE: [%s]\n", table.getBottomBorderSpace()) );
logger.log( String.format("TOP BORDER SPACE: [%s]\n", table.getTopBorderSpace()) );
logger.log( String.format("LEFT BORDER SPACE: [%s]\n", table.getLeftBorderSpace()) );
logger.log( String.format("RIGHT BORDER SPACE: [%s]\n", table.getRightBorderSpace()) );
logger.log( String.format("INSIDE HOR BORDER SPACE: [%s]\n", table.getInsideHBorderSpace()) );
logger.log( String.format("INSIDE VERT BORDER SPACE: [%s]\n", table.getInsideVBorderSpace()) );

logger.log( String.format("BOTTOM CELL MARGIN: [%s]\n", table.getCellMarginBottom()) );
logger.log( String.format("TOP CELL MARGIN: [%s]\n", table.getCellMarginTop()) );
logger.log( String.format("LEFT CELL MARGIN: [%s]\n", table.getCellMarginLeft()) );
logger.log( String.format("RIGHT CELL MARGIN: [%s]\n", table.getCellMarginRight()) );

关键修改说明 #

• 表格缩进清零：通过table.getCTTbl().getTblPr().addNewTblInd().setW(BigInteger.valueOf(0))消除表格整体的默认缩进
• 单元格CT层面边距设置：直接操作CTTcMar确保每个单元格的上下左右边距都为0，避免POI API的设置遗漏
• 段落底层间距清除：设置段落的spacing为0并指定EXACT规则，彻底清除Word段落的默认微小间距
• 移除重复Run：原代码中重复创建Run可能导致空内容占位，修正后只创建一次Run

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