使用Apache PDFBox填充PDF字段时出现数据格式异常问题排查

问题情况 #

代码能完成PDF字段填充并保存，但运行时会抛出压缩流相关异常，报错信息如下：

Caused by: java.util.zip.DataFormatException: invalid stored block lengths

ERROR FlateFilter FlateFilter: stop reading corrupt stream due to a DataFormatException

ERROR COSParser object stream 51 could not be parsed due to an exception

当前实现代码：

for (int dCounter = 4; dCounter < nColCount; dCounter++) {
    File adobeFile = new File(strDestFileName);

    PDDocument adobeDocument = Loader.loadPDF(adobeFile);
    PDDocumentCatalog adobeCatalog = adobeDocument.getDocumentCatalog();
    PDAcroForm adobeAcroForm = adobeCatalog.getAcroForm();
    PDField adobeField = adobeAcroForm.getField(strArrayHeaders[dCounter]);

    if(!Objects.equals(strArrayCellValues[dCounter], "")) {
        adobeField.setValue(strArrayCellValues[dCounter]);
    }
    FileOutputStream adobeOut = new FileOutputStream(adobeFile);
    adobeDocument.saveIncremental(adobeOut);

    adobeDocument.close();
}

报错原因 #

1. 反复读写同一文件破坏结构：循环里每次都打开同一个PDF，修改后直接覆盖保存。增量保存需要基于原文件的完整结构追加修改，来回折腾会搅乱文件的压缩流和对象流，解压时就会报块长度错误。
2. 增量保存用错场景：saveIncremental是给单次修改用的，循环里多次对同一文件执行增量保存，相当于在已修改的文件上叠加增量，次数多了文件对象流会损坏，解析器读不懂就报错。
3. IO流未正确关闭：FileOutputStream没被关闭，缓冲区内容没完全写入就结束操作，导致文件结构不完整，触发解压异常。

修复方案 #

优化逻辑，只加载一次PDF，批量修改所有字段后一次性保存，避免反复折腾同一文件：

// 仅加载一次目标PDF
File adobeFile = new File(strDestFileName);
PDDocument adobeDocument = Loader.loadPDF(adobeFile);
PDDocumentCatalog adobeCatalog = adobeDocument.getDocumentCatalog();
PDAcroForm adobeAcroForm = adobeCatalog.getAcroForm();

// 循环批量填充所有需要修改的字段
for (int dCounter = 4; dCounter < nColCount; dCounter++) {
    PDField adobeField = adobeAcroForm.getField(strArrayHeaders[dCounter]);
    if (!Objects.equals(strArrayCellValues[dCounter], "")) {
        adobeField.setValue(strArrayCellValues[dCounter]);
    }
}

// 用try-with-resources自动管理IO流，一次性保存并关闭资源
try (FileOutputStream adobeOut = new FileOutputStream(adobeFile)) {
    adobeDocument.save(adobeOut); // 不需要增量的话用save更稳定；若需增量，确保只执行这一次
} finally {
    adobeDocument.close();
}

额外提醒 #

• 若必须使用增量保存（比如原PDF体积过大），务必只对原文件执行一次增量保存，不要在循环中反复调用。
• 始终用try-with-resources管理IO流，保证流被正确关闭，避免资源泄漏和文件损坏。
• 先检查原PDF本身是否损坏，用PDF阅读器打开验证，排除原文件的问题。

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