我前阵子升级PDFBox到3.0的时候也踩过这个坑！确实原来的addSource(InputStream)方法被移除了，不过替代方案完全能保留你原来的业务逻辑，只是需要调整一下字节流的加载方式。

核心思路 #

PDFBox 3.0更注重资源的安全管理，现在PDFMergerUtility.addSource()接受的是PDDocument对象（也支持File/Path等类型），所以我们只需要把原来的byte[]先加载成PDDocument，再传入合并工具就可以了。

修改后的代码示例 #

Map<String, byte[]> documentList = new TreeMap<>();
// 这里假设你已经完成了documentList的填充逻辑

PDFMergerUtility pdfMergerUtility = new PDFMergerUtility();
pdfMergerUtility.setDestinationStream(outputStream);

documentList.forEach((key, value) -> {
    // 用try-with-resources自动关闭PDDocument，避免内存泄漏
    try (PDDocument pdfDoc = PDDocument.load(value)) {
        pdfMergerUtility.addSource(pdfDoc);
    } catch (IOException e) {
        // 根据你的业务场景处理异常，比如打印日志或抛出运行时异常
        throw new RuntimeException("加载PDF字节流失败，key: " + key, e);
    }
});

// 执行合并操作，传入内存使用配置（和旧版本默认行为一致）
pdfMergerUtility.mergeDocuments(MemoryUsageSetting.setupMainMemoryOnly());

关键注意点 #

• 资源关闭：一定要用try-with-resources包裹PDDocument，否则会导致PDF相关的内存资源无法释放，长期运行可能引发OOM
• 异常处理：PDDocument.load(byte[])会抛出IOException，需要显式处理（旧版本的addSource(InputStream)其实也会隐式抛出异常，只是没显式声明）
• 内存配置：mergeDocuments()方法现在必须传入MemoryUsageSetting，setupMainMemoryOnly()是和旧版本行为最接近的配置——完全在内存中处理合并；如果你的PDF文件很大，可以考虑用setupTempFile()来启用磁盘缓存，减少内存压力

内容来源于stack exchange