使用iText 8.0.3.0为已签名PAdES PDF添加附件后签名失效求助

使用iText 8.0.3.0（基于.NET Framework 4.7.2）为已签名的PAdES格式PDF文件添加XML附件后，签名失效，Foxit、Acrobat及在线工具检测报错：

签名/签章不是有效的AdES数字签名！
/ByteRange字典不一致！
引用数据对象不完整！

相关代码如下：

string pdfIN = "test.pdf";
string pdfOut = "testout.pdf";

PdfReader oReader = new PdfReader(pdfIN);
PdfWriter oWriter = new PdfWriter(pdfOut);
PdfDocument oPdfDocument = new PdfDocument(oReader, oWriter);

var bytes = File.ReadAllBytes(pdfIN);

PdfFileSpec fs = PdfFileSpec.CreateEmbeddedFileSpec(oPdfDocument, bytes, "Test insert attachment", "cda.xml", PdfName.ApplicationXml, null, new PdfName("Data"));
oPdfDocument.AddFileAttachment("cda.xml", fs);
oPdfDocument.Close();

• 核心错误原因：直接用PdfReader+PdfWriter的常规模式修改已签名PDF，会重写整个文件结构，破坏PAdES签名依赖的/ByteRange字典（该字典记录签名覆盖的原始文件字节范围），导致签名校验失败。PAdES签名是对原始PDF特定字节范围的哈希值签名，任何修改该范围的操作都会使签名失效。

• 代码细节错误：

  1. 错误将原PDF的全部字节作为附件内容传入CreateEmbeddedFileSpec，不仅冗余，还进一步干扰文件结构，应该读取目标XML文件的字节。
  2. 未使用iText专为已签名PDF设计的增量更新模式，而是用普通写入方式修改文件。

• 正确实现方案：

  1. 启用增量更新模式打开PDF：通过PdfReader.SetAppendMode()开启，此模式仅在PDF末尾添加新内容（附件），不会修改原始签名覆盖的字节区域。
  2. 读取目标XML文件的字节作为附件内容。
  3. 完成附件添加后正常关闭文档，确保增量更新生效。

• 修正后的代码：

string pdfIN = "test.pdf";
string pdfOut = "testout.pdf";
string xmlPath = "cda.xml";

// 启用增量更新模式打开PDF
PdfReader oReader = new PdfReader(pdfIN);
PdfWriter oWriter = new PdfWriter(pdfOut);
oReader.SetAppendMode(); // 关键：启用增量更新
PdfDocument oPdfDocument = new PdfDocument(oReader, oWriter);

// 读取XML文件的字节作为附件内容
var xmlBytes = File.ReadAllBytes(xmlPath);

// 创建正确的附件文件规范
PdfFileSpec fs = PdfFileSpec.CreateEmbeddedFileSpec(
    oPdfDocument, 
    xmlBytes, 
    "XML附件描述", 
    "cda.xml", 
    PdfName.ApplicationXml, 
    null, 
    new PdfName("Data")
);
oPdfDocument.AddFileAttachment("cda.xml", fs);

oPdfDocument.Close();

• 补充说明：增量更新是修改已签名PDF且保留签名有效性的唯一合法方式，符合PDF规范中对已签名文档的修改要求——仅允许在文档末尾添加新修订内容，不触碰原始签名覆盖的字节区域。修改后的PDF签名仍会被校验为有效，同时附件可正常读取。

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