PDF同一页面多处放置同一外部签名容器的技术问询

针对你遇到的在PDF多位置放置同一签名容器但仅一个字段有效的问题，以及相关的三个疑问，我来逐一解答：

1. PdfLiteral和PdfIndirectReference的参考资料 #

这两个类是iTextSharp对PDF底层对象模型的直接封装，想要搞懂它们的工作原理，推荐这几个方向：

• iText官方书籍：《iText in Action》（第二版及以后）专门有章节讲解PDF的核心对象模型，其中详细说明了间接引用（对应PdfIndirectReference）和字面量（对应PdfLiteral）的作用——PdfIndirectReference用于标记PDF中可复用的对象（比如签名值、外观），让多个地方可以指向同一个对象；PdfLiteral则是直接写入符合PDF语法的原始字符串，用于操作一些底层PDF结构。
• iTextSharp源码注释：因为iTextSharp是iText的.NET移植版本，源码中的类注释和方法注释会明确说明这些类的使用场景，比如PdfIndirectReference的注释会提到它代表PDF中的间接对象引用，而PdfLiteral用于创建原始PDF语法片段。
• PDF官方规范（ISO 32000）：这是最根本的参考，里面定义了PDF的所有底层结构，包括间接对象、字面量的语法和用途，iText的所有类都是基于这个规范实现的。

2. PDF注释/签名字段的数量限制 #

PDF官方规范本身没有硬性的数量限制，实际使用中主要受两个因素影响：

• 阅读器的性能：大量签名字段（比如上百个）可能会让旧版阅读器渲染卡顿，但现代主流阅读器（如Adobe Acrobat、Chrome内置阅读器）都能处理。
• 文件大小和结构效率：过多的字段会增加PDF文件大小，但只要符合规范，文件依然是有效的。

你之前遇到的仅一个字段有效，不是数量限制导致的，而是签名值没有正确关联到所有字段。

3. 使用BlankSignatureContainer和MakeSignature.SignDeferred关联所有字段 #

MakeSignature.SignDeferred默认只接受单个字段名，但要让多个字段关联同一签名值，核心思路是：先为所有字段创建空白签名占位符，签名完成后将同一个签名对象的间接引用赋值给所有字段的V（值）条目。具体步骤如下：

步骤1：为所有目标签名字段创建空白签名占位符 #

// 假设你有一个包含所有签名字段名的列表
List<string> signatureFieldNames = new List<string> { "Sig1", "Sig2", "Sig3" };
PdfReader reader = new PdfReader("input.pdf");
MemoryStream outputStream = new MemoryStream();
PdfStamper stamper = PdfStamper.CreateSignature(reader, outputStream, '\0');

// 存储每个字段的空白签名引用
Dictionary<string, PdfIndirectReference> blankSigRefs = new Dictionary<string, PdfIndirectReference>();

foreach (string fieldName in signatureFieldNames)
{
    PdfSignatureAppearance appearance = stamper.SignatureAppearance;
    // 为每个字段设置独立的显示位置和页码
    appearance.SetVisibleSignature(new Rectangle(100, 100, 200, 150), 1, fieldName); 
    BlankSignatureContainer blankContainer = new BlankSignatureContainer(PdfName.ADOBE_PPKLITE, PdfName.ADBE_PKCS7_DETACHED);
    
    // 为当前字段创建空白签名占位符，获取其间接引用
    PdfIndirectReference blankRef = stamper.SignatureFieldDictionary.AddSignature(appearance, blankContainer);
    blankSigRefs.Add(fieldName, blankRef);
}

// 关闭stamper，得到包含空白签名占位符的临时PDF
stamper.Close();

步骤2：执行Deferred签名，获取签名值的间接引用 #

// 读取临时PDF
PdfReader tempReader = new PdfReader(outputStream.ToArray());
MemoryStream finalStream = new MemoryStream();
PdfStamper finalStamper = PdfStamper.CreateSignature(tempReader, finalStream, '\0');

// 选择第一个字段执行SignDeferred
string firstFieldName = signatureFieldNames[0];
PdfSignatureAppearance finalAppearance = finalStamper.SignatureAppearance;
finalAppearance.SetVisibleSignature(firstFieldName);

// 替换成你的自定义签名容器实现（包含实际签名逻辑）
IExternalSignatureContainer signatureContainer = new YourCustomSignatureContainer(); 

// 执行签名，得到签名值的间接引用
PdfIndirectReference signedRef = MakeSignature.SignDeferred(finalStamper, firstFieldName, tempReader, signatureContainer);

步骤3：将签名值引用复制到所有其他字段 #

// 获取PDF的AcroForm字典
PdfDictionary acroForm = finalStamper.AcroForm;
if (acroForm != null)
{
    PdfDictionary fields = acroForm.GetAsDict(PdfName.FIELDS);
    if (fields != null)
    {
        foreach (PdfObject fieldObj in fields.Values)
        {
            if (fieldObj.IsIndirect())
            {
                PdfDictionary fieldDict = tempReader.GetPdfObject(fieldObj.GetIndirectReference()) as PdfDictionary;
                if (fieldDict != null)
                {
                    string fieldName = fieldDict.GetAsString(PdfName.T).ToString();
                    // 如果是目标字段且不是第一个已签名的字段
                    if (signatureFieldNames.Contains(fieldName) && fieldName != firstFieldName)
                    {
                        // 将字段的V（值）设置为签名值的间接引用
                        fieldDict.Put(PdfName.V, signedRef);
                        // 更新字段状态为已签名
                        fieldDict.Put(PdfName.Ff, new PdfNumber(fieldDict.GetAsNumber(PdfName.Ff).LongValue | PdfFormField.SIGNATURE));
                    }
                }
            }
        }
    }
}

// 关闭最终的stamper
finalStamper.Close();

关键注意点： #

• 所有签名字段的外观可以复用同一个间接引用，避免重复生成外观，减少文件大小。
• 确保每个字段的Ff（标志）属性包含SIGNATURE位，让阅读器识别为签名字段。
• 签名完成后，所有字段的V条目都指向同一个签名对象，这样阅读器会识别所有字段为已签名状态。

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