如何为PDF签名字段的子元素设置自定义签名外观

完全可以实现和常规单签名场景完全一致的自定义外观效果，你现在的实现思路有几个不符合PDF规范的问题，调整后就能正常使用：

• 别给每个签名位置单独新建PdfSignatureFormField实例。你现在的写法是造了多个独立签名字段挂在父字段下，还共用同一个签名字典，PDF阅读器校验的时候大概率会报签名结构错误。正确逻辑是只保留你从AcroForm取到的那一个根签名字段，所有位置的控件都作为这个根字段的widget子项，统一关联同一个签名值、复用同一个外观流，所有位置的显示效果自然完全一致。
• 你现在代码里给每个子项单独setFieldName、单独putPdfName.V的操作全删掉，签名值字典V只需要在最外层根签名字段上设置一次就行，子widget不需要重复绑定签名值。
• 自定义外观的绘制逻辑和单签名没有任何区别，你可以在外观流里随便绘制文本、印章图、签名线、时间戳等任意内容，只要把同一个外观对象赋值给所有位置widget的AP/N条目，所有签名位的显示就会完全统一。
• 别重复绑定注解：给字段addKid关联widget的时候iText会自动处理注解和页面的绑定关系，不用额外再调page.addAnnotation(widget)，重复添加容易出现注解重复渲染、位置偏移的问题。

修正后的核心代码参考 #

根字段绑定多签名位逻辑：

PdfSignatureFormField sigField = (PdfSignatureFormField) acroForm.getField(fieldName);
// 提前生成所有签名位共用的自定义外观
PdfFormXObject sharedSigAppearance = buildSigAppearance(100, 40, document);
// 给根字段挂不同位置的签名控件，不需要新建子签名字段
sigField.addKid(createSigWidget(pdfPage, 40, 700, 100, 40, sharedSigAppearance));
sigField.addKid(createSigWidget(pdfPage, 400, 600, 100, 40, sharedSigAppearance));
// 签名值仅绑定到根字段
sigField.put(PdfName.V, signatureDictionary);

通用签名外观构建方法，和单签名场景写法完全一致：

private static PdfFormXObject buildSigAppearance(float width, float height, PdfDocument doc) {
    PdfFormXObject appearance = new PdfFormXObject(new Rectangle(width, height));
    PdfCanvas pdfCanvas = new PdfCanvas(appearance, doc);
    // 此处可自由实现任意自定义绘制逻辑
    try (Canvas canvas = new Canvas(pdfCanvas, new Rectangle(width, height))) {
        canvas.showTextAligned("电子签名", 2, 22, TextAlignment.LEFT);
        canvas.showTextAligned("202X-XX-XX 12:00", 2, 2, TextAlignment.LEFT);
    }
    return appearance;
}

签名位置控件创建方法：

public static PdfWidgetAnnotation createSigWidget(PdfPage page, float x, float y, float width,
      float height, PdfFormXObject sharedAppearance) {
    PdfWidgetAnnotation widget = new PdfWidgetAnnotation(new Rectangle(x, y, width, height));
    widget.setFlags(PdfAnnotation.PRINT | PdfAnnotation.LOCKED);
    widget.setPage(page);
    PdfDictionary ap = new PdfDictionary();
    // 所有控件复用同一个外观流
    ap.put(PdfName.N, sharedAppearance.getPdfObject());
    widget.put(PdfName.AP, ap);
    return widget;
}

补充：这种单签名多展示位的写法符合PDF 2.0规范，Adobe Acrobat、福昕等主流阅读器都能正常识别，校验时只会判定为一个有效签名，不会出现重复校验的问题，自定义外观的自由度和单签名场景完全没有区别。

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