iText7生成PDF时页眉页脚异常问题求助

针对你遇到的三个问题，逐一给出排查方向和解决办法：

问题1：第一页未生成页眉，页脚正常 #

• 检查页面事件处理器的触发逻辑：如果代码中仅对当前页码 > 1的页面绘制页眉，会直接导致第一页无页眉。改用END_PAGE事件，确保每一页都执行页眉绘制。
• 确认文档边距设置：页眉绘制的Y坐标如果超出Document的顶部边距范围，会被自动裁剪。设置足够的顶部边距（比如doc.setMargins(40, 30, 40, 30)），给页眉预留空间。

问题2：添加Table后页眉区域出现随机矩形 #

• 验证Table边框：临时关闭Table的边框（table.setBorder(Border.NO_BORDER)），如果矩形消失，说明是Table的边框溢出到了页眉区域。调整Table的边框样式或确保Table宽度不超过页面主体区域（页面宽度减去左右边距）。
• 检查页面层级：Table渲染时可能覆盖页眉区域，或者页眉绘制在Table底层导致被遮挡。绘制页眉时，使用page.newContentStreamBefore()将页眉放在内容底层，或newContentStreamAfter()放在顶层，避免层级冲突。
• 排查Table内容溢出：如果Table的行高或内容超出主体区域，会延伸到页眉/页脚区域。确保Table总高度在页面主体可容纳范围内，必要时启用分页。

修正后的示例代码 #

import com.itextpdf.kernel.geom.Rectangle;
import com.itextpdf.kernel.pdf.*;
import com.itextpdf.kernel.pdf.canvas.PdfCanvas;
import com.itextpdf.layout.Canvas;
import com.itextpdf.layout.element.Cell;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.layout.element.Table;
import com.itextpdf.layout.properties.TextAlignment;
import com.itextpdf.layout.properties.UnitValue;
import com.itextpdf.kernel.events.IEventHandler;
import com.itextpdf.kernel.events.Event;

class HeaderFooterEventHandler implements IEventHandler {
    private PdfDocument pdfDoc;
    private String headerText;

    public HeaderFooterEventHandler(PdfDocument pdfDoc, String headerText) {
        this.pdfDoc = pdfDoc;
        this.headerText = headerText;
    }

    @Override
    public void handleEvent(Event event) {
        PdfDocumentEvent docEvent = (PdfDocumentEvent) event;
        PdfPage page = docEvent.getPage();
        int pageNumber = pdfDoc.getPageNumber(page);
        Rectangle pageSize = page.getPageSize();
        // 使用newContentStreamBefore确保页眉在内容底层，避免被Table覆盖
        PdfCanvas canvas = new PdfCanvas(page.newContentStreamBefore(), page.getResources(), pdfDoc);
        Canvas canvasWrapper = new Canvas(canvas, pdfDoc, pageSize);

        // 绘制页眉（所有页面都显示）
        Paragraph header = new Paragraph(headerText)
                .setTextAlignment(TextAlignment.CENTER)
                .setFontSize(10);
        canvasWrapper.showTextAligned(header, pageSize.getWidth() / 2, pageSize.getTop() - 20, TextAlignment.CENTER);

        // 绘制页脚
        Paragraph footer = new Paragraph(String.format("Page %d", pageNumber))
                .setTextAlignment(TextAlignment.CENTER)
                .setFontSize(10);
        canvasWrapper.showTextAligned(footer, pageSize.getWidth() / 2, pageSize.getBottom() + 20, TextAlignment.CENTER);

        canvasWrapper.close();
    }
}

public class PdfGenerator {
    public static void main(String[] args) throws Exception {
        PdfWriter writer = new PdfWriter("header_footer.pdf");
        PdfDocument pdfDoc = new PdfDocument(writer);
        // 设置足够的边距，避免内容与页眉页脚重叠
        Document doc = new Document(pdfDoc, PageSize.A4);
        doc.setMargins(40, 30, 40, 30);

        // 绑定事件处理器到END_PAGE事件，确保每一页都触发
        pdfDoc.addEventHandler(PdfDocumentEvent.END_PAGE, new HeaderFooterEventHandler(pdfDoc, "业务文档页眉"));

        // 添加符合要求的Table
        Table table = new Table(UnitValue.createPercentArray(3)).useAllAvailableWidth();
        // 临时关闭边框验证问题
        // table.setBorder(Border.NO_BORDER);
        for (int i = 0; i < 15; i++) {
            table.addCell(new Cell().add(new Paragraph("表格单元格 " + (i + 1))));
        }
        doc.add(table);

        doc.close();
    }
}

关键注意点 #

• 务必使用PdfDocumentEvent.END_PAGE事件，而非仅在startPage中处理，确保第一页不会遗漏页眉。
• 页面边距设置要足够，给页眉、页脚和主体内容分别预留独立区域，避免内容重叠。
• 若矩形是Table边框导致，可调整边框的绘制范围，或使用setBorderRadius等样式避免溢出。

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