itextpdf 5.4.4合并PDF偶发Adobe Reader无法打开文件求助

常见偶发损坏的触发原因 #

• 代码未正确释放PDF读取、写入流，高并发场景下输出流未完成刷写就被系统回收，导致文件内容截断
• 使用旧式页面拷贝逻辑（PdfWriter.getImportedPage）合并文件时，未拷贝源PDF的共享字体、交叉引用表结构，生成的PDF文件内部对象引用错位
• 未兼容解析带空密码加密、增量更新结构的源PDF，5.4.4版本读取这类文件时会偶发解析失败，生成空结构的损坏文件
• 未对合并后的输出文件做结构完整性校验，损坏文件直接进入生产返回链路

生产环境可直接落地的修正实现 #

核心代码调整（完全适配5.4.4版本API） #

public static void mergePdfs(List<byte[]> sourcePdfBytes, String outputPath) throws Exception {
    OutputStream outputStream = null;
    Document document = null;
    PdfCopy copy = null;
    try {
        outputStream = new FileOutputStream(outputPath);
        document = new Document();
        // 使用PdfCopy替代旧式PdfWriter拷贝逻辑，保证内部对象引用完整
        copy = new PdfCopy(document, outputStream);
        document.open();
        for (byte[] pdfBytes : sourcePdfBytes) {
            PdfReader reader = null;
            try {
                // 兼容空密码加密的PDF文件
                reader = new PdfReader(pdfBytes, null);
                // 校验源PDF有效性，跳过空文件/结构损坏的源文件
                if (reader.getNumberOfPages() <= 0) {
                    continue;
                }
                // 整理带增量更新结构PDF的命名目标引用，避免页面对象错位
                reader.consolidateNamedDestinations();
                // 逐页拷贝全量内容，保留源文件的字体、注释等附加结构
                copy.addDocument(reader);
            } finally {
                if (reader != null) {
                    reader.close();
                }
            }
        }
        // 强制刷写所有内存缓冲的PDF结构到底层输出流
        copy.flush();
    } finally {
        // 按依赖顺序关闭资源，避免流截断导致的文件结构缺失
        if (document != null) {
            document.close();
        }
        if (outputStream != null) {
            outputStream.close();
        }
    }
}

生产防护逻辑补充 #

• 合并完成后，使用PdfReader重新加载生成的输出文件，校验是否能正常读取总页数、是否存在损坏的内部对象；校验不通过的文件触发自动重试，最多重试2次仍失败则记录异常日志，不对外返回损坏文件
• 业务场景涉及带XFA表单的PDF文件时，建议将依赖升级到5.x线最终稳定版，该版本完全兼容5.4.4的调用逻辑，修复了5.4.4版本拷贝带XFA内容时的交叉引用偏移计算bug
• 高并发场景下，每个合并任务的临时输出文件设置独立的磁盘缓冲，避免大文件全量驻留内存导致OOM引发的写出截断
• 禁止使用内存字节数组作为最终输出载体直接返回，优先使用临时文件落盘后再做读取传输，减少内存操作的截断风险

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