iText 7追加页面后PDF扩展功能失效，如何保留签名与表单功能？

问题描述 #

以追加模式打开带Reader启用权限的PDF时，填写表单字段不会破坏文档签名，但添加新页面并附加图片后，PDF的表单扩展功能（如填写字段、下拉框）便无法使用。

使用的核心代码：

打开文档代码 #

PdfDocument pdfDoc = new PdfDocument(pdfReader, new PdfWriter(outputStream), new StampingProperties().useAppendMode());

添加新页面代码 #

PdfPage page = pdfDoc.getPage(1); 
pdfDoc.addNewPage(pdfDoc.getNumberOfPages() + 1, new PageSize(page.getPageSize()));

需求：能否在添加页面、附加图片的同时，既不破坏文档签名，又保留表单填写保存功能？（注：移除使用权限的方案不可行）

解决方案 #

问题本质 #

带Reader启用权限的PDF依赖Acrobat Reader的特殊许可支持表单填写等扩展功能。直接用追加模式添加新页面时，修改了文档的页面树结构，触发了权限验证机制，导致原有表单交互权限失效，同时还可能威胁签名完整性。

可行实现方式 #

要同时满足三个需求，必须严格遵循PDF增量更新规范，且完整保留原有权限设置：

• 开启追加模式时保留加密/权限：调用preserveEncryption()是核心，确保原有Reader权限不被破坏。
• 安全添加页面：iText7的addNewPage()在追加模式下会自动增量添加，无需手动修改原有页面树。
• 增量添加图片资源：所有新资源（图片、元素）都追加到文档末尾，不改动原有资源字典。

调整后的代码示例 #

// 关键配置：追加模式+保留原有权限
StampingProperties stampingProps = new StampingProperties()
    .useAppendMode()
    .preserveEncryption();
PdfDocument pdfDoc = new PdfDocument(pdfReader, new PdfWriter(outputStream), stampingProps);

// 安全添加新页面（匹配原页面尺寸）
PdfPage newPage = pdfDoc.addNewPage(pdfDoc.getNumberOfPages() + 1, new PageSize(pdfDoc.getPage(1).getPageSize()));
// 向新页面添加图片
ImageData imageData = ImageDataFactory.create("your-image-path.jpg");
Image image = new Image(imageData);
newPage.addElement(image);

pdfDoc.close();

注意要点 #

• 绝对不能修改原有文档的任何内容（如原有表单字段、签名字典、旧页面内容），所有操作只能是新增。
• 如果文档存在多个签名，追加模式默认会维护签名完整性，但不要手动修改签名相关字典，避免影响哈希计算。
• 测试时建议用Acrobat Reader验证，其他PDF阅读器对Reader权限的支持可能存在差异。

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