使用OpenPDF合并PDF时第二个PDF来源页面显示空白如何解决

第二个PDF页面渲染空白是典型的OpenPDF类使用错误，核心原因两点：

1. 你选用的PdfWriter设计用途是从零生成新PDF，不适合做多PDF合并。PdfImportedPage只是对原PDF页面的引用指针，不会自动将页面依赖的字体子集、嵌入图片、矢量资源、透明图层、注释依赖等写入输出文档。当同时加载多个PdfReader时，PdfWriter默认只会完整写入第一个PdfReader关联的全部资源，后续加载的PDF页面因为缺失依赖资源，自然渲染为空白——这也是原文件单独打开正常，合并后异常的原因：原文件自带完整资源，合并后的文件只带了第一个PDF的资源。
2. 你当前逐页调用addTemplate的写法本身就有缺陷，哪怕不出现空白，也会丢失原PDF的超链接、注释、表单字段、书签等结构化内容，手动设置页面尺寸、触发新页的逻辑也容易出现页面偏移、内容裁切问题。

直接换用OpenPDF专门提供的PDF合并类PdfCopy即可，这个类会自动处理跨PDF的资源关联、页面尺寸适配、结构化内容复制，不会出现资源丢失问题。
修复后的代码：

public byte[] mergePDF(byte[] pdf1, byte[] pdf2) throws IOException, DocumentException {
    ByteArrayOutputStream os = new ByteArrayOutputStream();
    Document document = new Document();
    // 用PdfCopy替换原PdfWriter，这是做PDF页面拼接的专用类
    PdfCopy copy = new PdfCopy(document, os);
    document.open();

    // 处理第一个PDF
    PdfReader reader1 = new PdfReader(pdf1);
    for (int i = 1; i <= reader1.getNumberOfPages(); i++) {
        copy.addPage(copy.getImportedPage(reader1, i));
    }
    reader1.close();

    // 处理第二个PDF
    PdfReader reader2 = new PdfReader(pdf2);
    for (int i = 1; i <= reader2.getNumberOfPages(); i++) {
        copy.addPage(copy.getImportedPage(reader2, i));
    }
    reader2.close();

    document.close();
    return os.toByteArray();
}

补充说明 #

• 如果需要合并后保留原文件的书签、表单，或者希望合并后的文件体积更小，可以用PdfSmartCopy替换基础PdfCopy，它会自动识别并去重不同PDF里的重复资源。
• 不要尝试在原有PdfWriter的代码基础上补参数修复，手动维护多PDF的资源引用逻辑复杂度极高，很容易遗漏透明内容、特殊字体、可选图层等边缘场景，用官方提供的专用合并类是唯一稳定的方案。

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