使用PDFBOX填充签名PDF表单后Acrobat显示异常及二次签名回退问题

我来帮你分析并解决这两个核心问题：表单域填充后Acrobat中默认不显示内容，以及二次签名后内容回退的问题。

问题1：填充后表单域内容默认不显示，点击才出现 #

这是因为带数字签名的PDF通常处于增量更新模式，而PDFBOX默认不会自动生成表单域的外观（Appearance）。你之前尝试设置needAppearances但注释掉了，其实这个属性是关键，但要结合增量更新的特性来正确设置。

核心原因 #

当PDF已有数字签名时，我们只能用增量更新来修改，而Acrobat在这种情况下依赖表单的NeedAppearances标志来决定是否自动生成外观。如果该标志为false，Acrobat不会主动渲染，只有点击域时才触发渲染。

问题2：二次签名后内容回退到原值 #

这个问题出在你修改表单域时，没有正确处理签名PDF的表单域锁定逻辑，同时修改的内容没有被正确标记为增量更新的一部分，导致Acrobat在验证签名时回退到签名前的状态。

核心原因 #

带签名的PDF中，表单域的原始值会被包含在签名的签名字典中，当你二次签名时，Acrobat会校验表单域的状态，如果你的修改没有正确更新表单域的所有关联字典（包括父节点、外观字典），并且没有正确处理AppendOnly和SignaturesExist属性，就会触发回退。

修正后的解决方案 #

下面是整合了两个问题修复的代码，关键改动点我会标注出来：

File inFile = new File("pdfFile/Untitled_sign.pdf");
OutputStream outFile = new FileOutputStream("pdfFile/Untitled_sign_2.pdf");
PDDocument pdfDocument = PDDocument.load(inFile);

try {
    PDAcroForm acroForm = pdfDocument.getDocumentCatalog().getAcroForm();
    Set<COSDictionary> cosDis = new HashSet<>();

    if (acroForm != null) {
        // 关键1：开启NeedAppearances，让Acrobat自动渲染表单域外观
        acroForm.setNeedAppearances(true);
        acroForm.getCOSObject().setNeedToBeUpdated(true);

        List<PDField> fields = acroForm.getFields();
        for (PDField field : fields) {
            if (field instanceof PDTextField && field.getFullyQualifiedName().equals("Text1")) {
                try {
                    field.setValue("100");
                    System.out.println("New value: " + field.getValueAsString());
                } catch (IOException e) {
                    e.printStackTrace();
                }

                // 标记当前域需要更新
                field.getCOSObject().setNeedToBeUpdated(true);
                cosDis.add(field.getCOSObject());

                // 处理所有Widget的外观和字典
                for (PDAnnotationWidget widget : field.getWidgets()) {
                    widget.getCOSObject().setNeedToBeUpdated(true);
                    if (widget.getAppearance() != null) {
                        widget.getAppearance().getCOSObject().setNeedToBeUpdated(true);
                    }
                    cosDis.add(widget.getCOSObject());
                }

                // 递归标记所有父节点需要更新
                COSDictionary parentDict = field.getCOSObject();
                while ((parentDict = (COSDictionary) parentDict.getDictionaryObject(COSName.PARENT)) != null) {
                    parentDict.setNeedToBeUpdated(true);
                    cosDis.add(parentDict);
                }
            }
        }

        // 关键2：正确设置签名相关属性，避免回退
        acroForm.setSignaturesExist(true);
        acroForm.setAppendOnly(true);
        acroForm.getCOSObject().setDirect(true);

        // 标记AcroForm和Catalog需要更新
        cosDis.add(acroForm.getCOSObject());
        cosDis.add(pdfDocument.getDocumentCatalog().getCOSObject());
    }

    // 执行增量保存
    pdfDocument.saveIncremental(outFile, cosDis);
} finally {
    // 确保资源正确释放
    pdfDocument.close();
    outFile.close();
}

关键改动说明 #

1. 开启NeedAppearances：

   • 这会告诉Acrobat在打开PDF时自动生成表单域的外观，不需要点击才显示内容。注意必须在增量更新前设置并标记该字典需要更新。

2. 完整标记所有关联字典：

   • 不仅标记表单域本身，还要标记所有Widget、父节点、外观字典，确保增量更新时这些改动被正确写入，避免Acrobat在签名时忽略修改。

3. 正确设置签名属性：

   • setSignaturesExist(true)和setAppendOnly(true)告诉PDFBOX和Acrobat这个PDF已有签名，只能增量修改，不能覆盖原始内容，这是防止签名回退的核心。

4. 资源释放：

   • 添加finally块确保文档和流被正确关闭，避免资源泄漏。

验证步骤 #

1. 用上述代码填充表单域，打开PDF时内容会直接显示，无需点击域。
2. 第一次签名后，再次用代码修改内容，然后二次签名，内容不会回退到原值。

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