使用Apache PDFBox转换PDF/A时文件损坏或为空问题求助

核心错误：文档对象被提前关闭 #

你的initializeDocument方法使用try-with-resources语法加载PDF，该语法会在try块执行完毕后自动关闭loadedDoc对象，但你将全局变量document赋值为loadedDoc，导致后续操作的document是已关闭的无效对象。这就是调用getDocumentCatalog()后保存文件要么为空要么损坏的根本原因——PDFBox无法对已关闭的文档执行写操作。

修复代码：调整文档加载逻辑 #

移除try-with-resources，确保文档在整个操作周期内保持打开状态，直到保存完成后再关闭：

private void initializeDocument() throws Exception {
    try {
        document = Loader.loadPDF(new RandomAccessReadBufferedFile(pdfInfo.getInputFile()));
        document.setVersion(1.7f);
    } catch (IOException ioException) {
        throw new Exception(ioException.getMessage());
    }
}

同时，saveFile方法中无需手动关闭fileOutputStream（try-with-resources会自动处理），且确保文档仅在保存后关闭：

private void saveFile() {
    try (OutputStream fileOutputStream = new FileOutputStream(pdfInfo.getOutputFile())) {
        document.save(fileOutputStream);
        document.close();
    } catch (Exception e) {
        // 替换为具体的异常处理逻辑，比如打印日志或抛出业务异常
        e.printStackTrace();
    }
}

PDF/A转换的额外合规要求 #

修复文档关闭问题后，要生成真正合规的PDF/A，还需满足以下要求：

• 强制字体嵌入：所有非系统标准字体必须嵌入PDF，否则PDF/A验证会失败，可通过PDFont的isEmbedded()方法检查并处理。
• 颜色空间规范：需使用PDF/A兼容的颜色空间（如RGB、CMYK、灰度），禁止使用DeviceN等特殊颜色空间。
• PDF/A验证：使用PDFBox自带的验证工具检查生成文件的合规性：

PDFAValidator validator = new PDFAValidator();
List<ValidationResult.ValidationError> errors = validator.validate(document);
if (!errors.isEmpty()) {
    for (ValidationResult.ValidationError error : errors) {
        System.err.println("PDF/A验证错误：" + error.getDetails());
    }
}

• 版本依赖一致性：确保PDFBox核心包、pdfbox-xmp、pdfbox-audit等依赖版本完全一致，避免版本冲突导致的异常。

优化建议：统一管理文档生命周期 #

推荐将文档的加载、修改、保存整个流程用try-with-resources包裹，彻底避免资源泄漏和无效对象问题：

public void convertToPdfA() throws Exception {
    try (PDDocument document = Loader.loadPDF(new RandomAccessReadBufferedFile(pdfInfo.getInputFile()))) {
        document.setVersion(1.7f);
        addMetadata(document);
        saveFile(document);
    } catch (IOException e) {
        throw new Exception(e.getMessage());
    }
}

private void addMetadata(PDDocument document) throws Exception {
    PDDocumentCatalog catalog = document.getDocumentCatalog();
    // 原有的元数据设置逻辑...
}

private void saveFile(PDDocument document) throws Exception {
    try (OutputStream fileOutputStream = new FileOutputStream(pdfInfo.getOutputFile())) {
        document.save(fileOutputStream);
    } catch (Exception e) {
        throw new Exception(e.getMessage());
    }
}

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