使用iText7扁平化已签名PDF表单字段致签名失效问题咨询

已签名PDF做常规表单扁平化后签名失效是PDF数字签名机制的固有特性，不是iText的bug：数字签名的校验本质是比对签名时留存的文档指定范围字节哈希值和当前文档对应字节的哈希值，只要你调用PdfAcroForm.FlattenFields()，无论是否提前调用PartiallyFlattenFields()标记扁平化范围，默认写出逻辑都会重写页面内容流、删除被扁平化的字段对象，直接改动签名覆盖的字节段，哈希校验必然不通过。

根据不同的业务要求，可选以下三种落地方式：

方案1：增量更新模式下做部分扁平化（适配允许签名后增量修改的场景） #

这是对原有签名影响最小的方案，核心逻辑是所有修改都写入文档末尾的增量更新块，完全不改动原签名覆盖的原始字节段，不会直接导致签名失效。要求原签名没有配置「禁止任何后续增量修改」的约束。
操作代码参考：

using (PdfReader reader = new PdfReader("your_signed_file.pdf"))
// 关键：Writer必须显式开启追加模式，禁止iText重写原有文档字节
using (PdfWriter writer = new PdfWriter("output_after_flatten.pdf", 
    new WriterProperties().UseAppendMode()))
using (PdfDocument pdfDoc = new PdfDocument(reader, writer))
{
    PdfAcroForm form = PdfAcroForm.GetAcroForm(pdfDoc, true);
    // 遍历字段，绝对不要把签名字段加入扁平化列表
    foreach (var fieldEntry in form.GetFormFields())
    {
        if (fieldEntry.Value is PdfSignatureField)
        {
            // 签名字段保留，标记为已修改避免被iText自动清理
            fieldEntry.Value.SetModified();
            continue;
        }
        // 普通表单字段标记为需要扁平化
        fieldEntry.Value.SetFlatten(true);
    }
    // 执行部分扁平化，不要调用全量FlattenFields方法
    form.PartialFlatten();
}

注意：该方案输出的文档，在Adobe Acrobat等标准阅读器中会显示「签名后文档做过允许范围的增量修改」，只要修改内容不触碰签名锁定的区域，签名会判定为有效；如果业务要求签名必须显示为「签署后无任何修改」的全绿状态，该方案不满足要求。

方案2：注释层模拟扁平化（适配强签名校验、不允许修改内容流的场景） #

如果原签名锁定了整个文档内容，哪怕增量更新修改内容流也会触发签名告警，就不能改动原有页面内容流和表单结构：

• 不要删除任何原有表单字段，仅给需要扁平化的普通字段添加Hidden标识，让阅读器不渲染原字段控件
• 提取普通字段的外观流，生成和字段坐标、尺寸完全匹配的屏幕注释，叠加到原字段位置
• 所有新增注释同样通过增量更新模式追加到文档末尾，全程不改动原文档的签名覆盖字节
  这种方式视觉上和扁平化效果完全一致，因为没有改动原内容流和字段结构，原有签名的哈希校验可以正常通过。

方案3：留存原签名信息后重签（适配必须做全量扁平化、不允许保留增量更新的场景） #

不存在任何方法可以在全量重写PDF结构的前提下保留原有签名的有效性——全量扁平化会重构整个PDF的字节结构，和原签名计算哈希时的原始字节完全不一致，签名必然失效。这种场景的标准处理流程是：

• 扁平化操作前先完成原签名的全量校验，留存签名人、签名时间、签名证书、校验结果等信息
• 关闭追加模式，正常执行全量表单扁平化
• 使用有效签名证书对扁平化后的新文档重新签章，可将原签名的留存信息写入新签名的自定义属性、签名原因字段中做溯源。

• 不要认为调用PartiallyFlattenFields()就不会破坏签名：只要没开追加模式，iText默认会重写全文档字节结构，哪怕只扁平化一个字段，也会导致签名哈希比对失败
• 绝对不要将签名字段纳入扁平化范围：签名字段被扁平化后会直接从文档结构中移除，签名会直接丢失
• 不要用整文档内存加载后重写保存的逻辑：只要不是追加模式写出，哪怕字节内容看起来没变，字节顺序、对象编号的变动也会导致哈希校验失败

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