这个问题在使用iText（Java生态下常用的PDF生成库）处理自动分页时很常见，核心问题是：自动分页后的新页面不会继承第一页手动添加的顶部空白，表格会直接从页面顶部开始渲染，进而覆盖页眉与Logo。手动添加的Paragraph("\n\n\n\n\n")只对第一页生效，因为分页后是全新的页面上下文，不会重复执行这个添加操作。

下面是具体的解决方案，按优先级排序：

1. 使用页面事件处理器（最推荐） #

通过自定义页面事件处理器，能确保每一页（包括自动生成的分页）都统一渲染页眉、Logo，并预留顶部空白。这是iText官方推荐的处理页眉页脚的方式，稳定性最高。

步骤示例： #

首先自定义一个继承自PdfPageEventHelper的事件处理器：

import com.itextpdf.text.*;
import com.itextpdf.text.pdf.*;

class CustomHeaderEvent extends PdfPageEventHelper {
    private Image headerLogo;
    private String headerText;

    // 构造方法传入Logo和页眉文本
    public CustomHeaderEvent(Image logo, String text) {
        this.headerLogo = logo;
        this.headerText = text;
    }

    @Override
    public void onEndPage(PdfWriter writer, Document document) {
        PdfContentByte contentByte = writer.getDirectContent();
        
        // 1. 添加Logo到页眉位置（左上角，距离顶部和左侧各10pt）
        headerLogo.setAbsolutePosition(document.left(), document.top() + 10);
        contentByte.addImage(headerLogo);
        
        // 2. 添加页眉文本（居中，距离顶部10pt）
        Font headerFont = new Font(Font.FontFamily.HELVETICA, 12, Font.BOLD);
        Phrase headerPhrase = new Phrase(headerText, headerFont);
        ColumnText.showTextAligned(
            contentByte,
            Element.ALIGN_CENTER,
            headerPhrase,
            (document.left() + document.right()) / 2, // 水平居中
            document.top() + 10, // 垂直位置（顶部下方10pt）
            0
        );
    }
}

然后在主代码中注册这个处理器，并设置合适的页面边距（预留页眉空间）：

public class PrintDemo {
    public static void main(String[] args) throws Exception {
        Document document = new Document(PageSize.A4);
        PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("print_output.pdf"));
        
        // 加载并调整Logo大小
        Image logo = Image.getInstance("logo.png");
        logo.scaleToFit(60, 60); // 根据需求调整尺寸
        
        // 注册页面事件处理器
        writer.setPageEvent(new CustomHeaderEvent(logo, "我的文档页眉"));
        
        // 设置页面边距：上边距80pt（足够放下Logo和页眉），左右下各36pt
        document.setMargins(80, 36, 36, 36);
        
        document.open();
        
        // 创建并填充表格（模拟多行数据触发自动分页）
        PdfPTable table = new PdfPTable(3);
        table.setWidthPercentage(100); // 表格宽度占满页面
        for (int i = 0; i < 150; i++) {
            table.addCell("行" + i + "列1");
            table.addCell("行" + i + "列2");
            table.addCell("行" + i + "列3");
        }
        
        // 直接添加表格，自动分页时会触发事件处理器渲染每页页眉
        document.add(table);
        
        document.close();
    }
}

2. 避免手动换行，用页面边距控制顶部空白 #

你之前用document.add(new Paragraph("\n\n\n\n\n"))的方式不可靠，因为它只作用于当前页。正确的做法是通过document.setMargins()设置全局的上边距，让所有页面的内容都从边距下方开始，自然避开页眉区域。

比如设置上边距为80pt：

document.setMargins(80, 36, 36, 36);

这样不管是第一页还是自动分页后的页面，表格都会从距离顶部80pt的位置开始渲染，不会覆盖页眉。

为什么手动换行失效？ #

手动添加的换行Paragraph("\n\n\n\n\n")只是在第一页的内容流中插入了空白，但自动分页时，iText会直接将表格的剩余内容渲染到新页面的默认起始位置（页面顶部），不会重复执行第一页的换行添加操作。而页面事件处理器会在每一页渲染时被调用，所以能确保每页都有一致的顶部空白和页眉。

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