基于PDFBox 2.0.25的多用户PDF签名及附加内容问题排查

一、消除“文档已被更新”提示的核心方案 #

首次实现中二次签名后出现提示，本质是签名后直接修改PDF内容（添加缩写），违反了PDF增量更新规则——签名后的PDF仅允许通过增量追加方式修改，不能改动原有对象。要解决这个问题，必须把缩写添加逻辑整合到签名的外观构建阶段，而非签名完成后修改文档：

• 使用PDFBox的PDSignatureAppearance或自定义外观构建工具，在生成签名外观时直接将姓名缩写文本或图片绘制到签名域的外观矩形内。
• 确保所有与签名相关的内容（包括缩写）都作为签名字典的一部分，通过增量更新追加到PDF末尾，不修改已有PDF对象。

示例代码片段：

// 获取目标签名域
PDSignatureField signatureField = (PDSignatureField) acroForm.getField(targetSignFieldName);
// 获取签名域的外观对象
PDAnnotationWidget widget = signatureField.getWidgets().get(0);
PDAppearance appearance = widget.getAppearance();
PDAppearanceStream normalAppearance = appearance.getNormalAppearance().getAppearanceStream();

// 追加内容到外观流
PDPageContentStream contentStream = new PDPageContentStream(document, normalAppearance, PDPageContentStream.AppendMode.APPEND, true);

// 绘制姓名缩写文本
contentStream.beginText();
contentStream.setFont(PDType1Font.HELVETICA_BOLD, 14);
contentStream.newLineAtOffset(15, 12); // 调整坐标适配签名域尺寸
contentStream.showText("ZH"); // 替换为实际姓名缩写
contentStream.endText();

// 若添加图片缩写，可使用以下逻辑
// PDImageXObject initialsImage = PDImageXObject.createFromFile("user_initials.png", document);
// contentStream.drawImage(initialsImage, 10, 8, 30, 20); // 调整位置和大小

contentStream.close();

二、解决预先添加占位字段导致的对象多版本引用问题 #

预先添加占位字段后出现多版本引用，是因为占位字段对象在后续签名的增量更新中被重复修改，导致PDF中出现同一对象的多个版本，破坏了对象引用一致性。可通过以下方式解决：

1. 为每个签名创建独立专属域 #

不要复用同一个占位字段，初始化PDF时为每个潜在签名用户创建独立的签名域（包含专属的缩写占位区域），每个域对应唯一标识。签名时仅操作当前用户对应的域，避免修改其他用户的域对象。

2. 签名后锁定已完成域并以增量模式保存 #

签名完成后，将当前签名域标记为只读，同时严格以增量更新模式保存文档，避免覆盖原有内容：

// 将已签名的域设置为只读
signatureField.setFlags(PDSignatureField.READ_ONLY);
// 增量保存文档，保留之前的签名和内容
document.saveIncremental(new FileOutputStream(outputFilePath));

3. 避免共享可修改的PDF资源对象 #

每个签名操作中使用的字体、图片等资源，都创建独立实例，不在多个签名域之间共享同一资源对象，防止资源被多次修改产生多版本。

三、关键注意事项 #

• 严格遵循PDF增量更新规则：签名后的PDF只能追加内容，禁止修改或删除已有对象。
• 所有签名外观的修改必须限定在签名字典的外观字典范围内，不得直接修改页面内容或非签名相关对象。
• 测试时务必用Adobe Acrobat Reader验证签名有效性和提示信息，确保符合PDF标准要求。

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