从iText2迁移至iText7合并PDF时的目标跳转异常问题咨询

核心原因 #

iText2的PdfCopy在合并时会自动检测并重命名重复的命名目标（如section.1），避免冲突；而iText7的copyPagesTo是底层页面复制方法，默认不处理这类高层的命名树冲突，导致重复的名称会被覆盖，最终所有同名链接都指向最后一个文档的目标位置。

简便解决方法：改用PdfMerger类 #

iText7提供了专门的PdfMerger工具类，它会自动处理命名树、大纲等合并时的冲突问题，完全替代手动处理copyPagesTo的繁琐操作。

代码示例 #

import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfReader;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.kernel.utils.PdfMerger;

import java.io.File;
import java.util.Arrays;

public class PdfMergeTool {
    public static void main(String[] args) {
        if (args.length < 2) {
            System.out.println("用法: java -jar pdf-merger.jar <输出文件> <源文件1> <源文件2> ...");
            return;
        }

        String outputPath = args[0];
        String[] sourcePaths = Arrays.copyOfRange(args, 1, args.length);

        try (PdfDocument mergedDoc = new PdfDocument(new PdfWriter(outputPath))) {
            PdfMerger merger = new PdfMerger(mergedDoc);

            for (String srcPath : sourcePaths) {
                File srcFile = new File(srcPath);
                if (!srcFile.exists()) {
                    System.out.println("跳过不存在的文件: " + srcPath);
                    continue;
                }
                try (PdfDocument srcDoc = new PdfDocument(new PdfReader(srcPath))) {
                    merger.merge(srcDoc, 1, srcDoc.getNumberOfPages());
                }
            }
            System.out.println("合并完成，输出文件: " + outputPath);
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

批处理自动化实现 #

1. 将上述代码打包成可执行jar包（如pdf-merger.jar）
2. 创建批处理脚本merge-pdfs.bat：

@echo off
chcp 65001 >nul
set "OUTPUT_FILE=merged.pdf"
set "SOURCE_FILES=report1.pdf report2.pdf report3.pdf"

:: 或者用通配符匹配当前目录下所有PDF
:: set "SOURCE_FILES=*.pdf"

java -jar pdf-merger.jar %OUTPUT_FILE% %SOURCE_FILES%
pause

运行该脚本即可自动合并指定的PDF文件，且不会出现链接跳转错误和命名树警告。

补充说明 #

如果坚持使用copyPagesTo，需要手动遍历源文档的命名树，重命名重复的目标名称（比如给每个文档的命名目标加上前缀/后缀），但这种方法繁琐且容易出错，远不如PdfMerger高效可靠。

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