iTextPDF：为PDF所有页面叠加静态模板的问题排查

你遇到的问题核心在于PdfImportedPage和它对应的PdfReader实例是强绑定的，同时资源关闭的顺序也出现了错误。咱们一步步拆解问题，找到正确的实现方式：

第一次代码的问题 #

你在循环里反复打开、关闭模板PDF的PdfReader，这不仅是不必要的资源浪费，更会导致iText生成无效的PDF结构——每次导入页面后立刻关闭Reader，后续PDF处理时会缺失必要的资源引用，最终生成损坏的文件。

第二次代码的问题 #

你修正了重复读取模板的问题，但提前关闭了templateReader。而PdfImportedPage在stamper.close()执行时，还需要依赖这个Reader来完成页面资源的最终写入，所以此时关闭Reader会触发IllegalStateException: Already closed异常。

正确的实现方式 #

正确的资源管理顺序应该是：

• 先打开内容PDF的Reader，创建Stamper
• 打开模板PDF的Reader，仅导入一次模板页面
• 遍历所有内容页，将模板添加到每一页的底层内容流
• 先关闭Stamper（完成所有PDF写入操作）
• 最后关闭两个Reader（或用try-with-resources自动管理）

修正后的代码（使用try-with-resources自动管理资源） #

import com.itextpdf.text.DocumentException;
import com.itextpdf.text.pdf.PdfContentByte;
import com.itextpdf.text.pdf.PdfImportedPage;
import com.itextpdf.text.pdf.PdfReader;
import com.itextpdf.text.pdf.PdfStamper;

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

public class PdfBackgroundApplier {
    public static void main(String[] args) throws IOException, DocumentException {
        File pdfContent = new File("content.pdf");
        File pdfTemplate = new File("template.pdf");
        File output = new File("pdf_output.pdf");

        if (output.exists()) {
            output.delete();
        }

        // try-with-resources自动管理资源，无需手动处理关闭顺序
        try (PdfReader contentReader = new PdfReader(new FileInputStream(pdfContent));
             PdfStamper stamper = new PdfStamper(contentReader, new FileOutputStream(output));
             PdfReader templateReader = new PdfReader(new FileInputStream(pdfTemplate))) {

            // 仅导入一次模板页面，避免重复资源加载
            PdfImportedPage templatePage = stamper.getImportedPage(templateReader, 1);

            // 遍历所有内容页，将模板作为背景添加到底层
            for (int i = 1; i <= contentReader.getNumberOfPages(); i++) {
                PdfContentByte underContent = stamper.getUnderContent(i);
                // 0,0坐标对应PDF左下角，适配A4横向的位置对齐
                underContent.addTemplate(templatePage, 0, 0);
            }
        }
        // try-with-resources会按逆序自动关闭所有资源，无需手动调用close()
    }
}

关键注意事项 #

• 不要提前关闭模板Reader：PdfImportedPage的内部实现依赖于它的PdfReader实例，直到PdfStamper完全完成PDF写入（stamper.close()执行完毕），这个Reader都不能关闭。
• 优先使用try-with-resources：Java 7+的这个特性可以帮你自动处理资源关闭顺序，避免手动关闭时出现的顺序错误。
• 仅导入一次模板页面：重复导入不仅浪费性能，还会导致PDF中出现重复的资源对象，无端增加文件体积。

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