Apache PDFBox：如何用saveIncremental加图片且不破坏已有签名？

现有方案问题分析 #

• 按钮表单域：调整域Rect尺寸属于修改签名保护的表单核心属性，必然导致之前的签名失效——这是PDF签名的安全机制决定的，签名会固化签署时的文档对象状态，修改被保护对象就会触发签名验证失败。
• 普通注解：新增注解默认不在旧签名的保护范围内，后续可被编辑删除，除非主动将其纳入锁定规则。

可行替代方案 #

1. 优化注解添加+锁字典锁定 #

添加图片注解后，通过锁字典（Lock Dictionary）将新增注解纳入保护范围，确保后续无法被编辑：

• 用PDFBox创建PDAnnotationStamp或自定义外观的PDAnnotationWidget插入图片，完全控制尺寸和位置；
• 增量保存前，创建文档级或签名域级的锁字典，指定锁定新增注解的ID或类型，锁字典的变更需作为增量更新的一部分，不触碰旧签名保护的对象；
• 锁字典可设置为仅允许特定操作，禁止注解的修改、删除操作。

2. 直接追加页面内容流绘制图片 #

绕过表单域和注解，直接在目标页面的内容流末尾追加图片绘制指令，这种方式属于页面内容的增量扩展，不会修改旧签名保护的对象：

• 以Append模式打开页面的PDPageContentStream（PDFBox 2.x中使用AppendMode.APPEND参数）；
• 将图片加载为PDImageXObject，通过drawImage方法绘制到指定位置，自由控制尺寸；
• 执行增量保存，图片会成为页面固定内容，天然无法被后续编辑（除非修改页面内容流，但只要后续操作也遵循增量规则且签名保护页面内容，就能保证完整性）。

3. 按钮域适配优化（仅当图片尺寸可提前规划时） #

如果坚持使用表单域，不要修改按钮域的Rect尺寸，而是通过调整外观流适配图片：

• 预先创建足够大尺寸的按钮域，后续仅更新其外观流的图片内容，不修改域的核心属性；
• 在外观流中通过矩阵变换缩放图片，使其适配域的尺寸，避免挤压变形。

库选择建议 #

若PDFBox的操作复杂度较高，可考虑使用iText 7（注意商业授权限制），它对增量更新、签名锁定的封装更简洁，支持直接锁定新增注解/内容，且提供更直观的页面内容追加API。

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