iText 7：末页设置不同页脚时出现PdfDictionary空指针异常

首先，你遇到的NullPointerException大概率是因为在文档关闭事件中直接遍历页面时，部分页面的内部结构还未完全初始化，导致调用newContentStream时找不到必要的字典项。咱们换一种更可靠的方式来实现——利用**页面结束事件（END_PAGE）**来处理页脚，同时准确判断当前页是否为末页。

实现步骤 #

1. 自定义页面事件处理器 #

创建一个实现IPdfDocumentEvent的类，在handleEvent方法中处理每页的页脚逻辑：

import com.itextpdf.kernel.events.Event;
import com.itextpdf.kernel.events.IEventHandler;
import com.itextpdf.kernel.events.PdfDocumentEvent;
import com.itextpdf.kernel.geom.Rectangle;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfPage;
import com.itextpdf.kernel.pdf.canvas.PdfCanvas;
import com.itextpdf.layout.Canvas;
import com.itextpdf.layout.element.Paragraph;
import com.itextpdf.layout.properties.TextAlignment;

public class FooterEventHandler implements IEventHandler {
    @Override
    public void handleEvent(Event event) {
        PdfDocumentEvent docEvent = (PdfDocumentEvent) event;
        PdfDocument pdfDoc = docEvent.getDocument();
        PdfPage page = docEvent.getPage();
        
        // 获取页面尺寸
        Rectangle pageSize = page.getPageSize();
        PdfCanvas canvas = new PdfCanvas(page.newContentStreamBefore(), page.getResources(), pdfDoc);
        Canvas layoutCanvas = new Canvas(canvas, pageSize);
        
        // 判断是否为最后一页
        boolean isLastPage = pdfDoc.getNumberOfPages() == page.getPageNumber();
        
        // 设置页脚内容
        String footerText;
        if (isLastPage) {
            footerText = "这是最后一页的专属页脚";
        } else {
            footerText = String.format("第 %d 页", page.getPageNumber());
        }
        
        // 绘制页脚（位置可根据需求调整）
        layoutCanvas.showTextAligned(new Paragraph(footerText),
                pageSize.getWidth() / 2,
                pageSize.getBottom() + 20,
                TextAlignment.CENTER);
        
        layoutCanvas.close();
    }
}

2. 注册事件处理器到PDF文档 #

在创建PdfDocument后，注册咱们的页脚事件处理器，监听END_PAGE事件：

import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.element.Paragraph;

import java.io.FileNotFoundException;

public class FooterExample {
    public static void main(String[] args) throws FileNotFoundException {
        PdfWriter writer = new PdfWriter("footer_example.pdf");
        PdfDocument pdfDoc = new PdfDocument(writer);
        Document doc = new Document(pdfDoc);
        
        // 注册页脚事件处理器
        pdfDoc.addEventHandler(PdfDocumentEvent.END_PAGE, new FooterEventHandler());
        
        // 添加文档内容
        for (int i = 1; i <= 5; i++) {
            doc.add(new Paragraph(String.format("这是第 %d 页的内容", i)));
            doc.add(new Paragraph("\n\n\n\n\n\n")); // 手动分页，方便测试
        }
        
        doc.close();
    }
}

为什么这种方式能避免空指针？ #

• END_PAGE事件是在每页内容渲染完成后触发的，此时页面的内部结构（包括内容流、资源字典）已经完全初始化，调用page.newContentStreamBefore()不会出现未初始化的字典项，也就避免了NPE。
• 直接通过事件参数获取当前页，不需要手动遍历所有页面，逻辑更简洁且安全。

额外注意事项 #

• 如果你的文档是动态生成的（比如内容不确定页数），pdfDoc.getNumberOfPages()在END_PAGE事件中是准确的，因为iText7会实时更新页面计数。
• 若需要调整页脚的样式（字体、大小、颜色），可以通过Paragraph的setFont()、setFontSize()等方法设置。

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