iText7签名后签名字段仍显示未签名及签名不可见问题求助

1. 签署后原有字段仍显示未签署的问题 #

原始代码的核心问题是没有将签名操作关联到文档中已有的签名字段，iText默认会生成新的隐藏签名字段完成签名流程，原有字段自然不会被标记为已签署。
修复方案：在调用signDetached方法前，显式指定要签署的已有字段名，同时可以删除手动读取字段矩形、手动设置签名位置的冗余代码，iText会自动复用已有签名字段的位置、页码、属性配置：

String fieldName = "signature1";
// 不需要手动读取字段矩形和设置位置
PdfSignatureAppearance appearance = pdfSigner.getSignatureAppearance().setReason("Test")
    .setLocation("Test").setReuseAppearance(false);
// 关键配置：指定要签署的已有字段
pdfSigner.setFieldName(fieldName);
IExternalSignature pks =
     new PrivateKeySignature(pk, DigestAlgorithms.SHA256, provider.getName());
pdfSigner.signDetached(new BouncyCastleDigest(), pks, chain, null, null, null, 0, CryptoStandard.CMS);

2. 指定字段名后签名不显示的问题 #

部分PDF设置字段名后签名不可见，是以下常见原因导致，按顺序排查即可：

• 已有签名字段属性异常：检查目标签名字段是否设置了/F标志位的NoView、Hidden属性，或者字段默认外观（/DA）为空/无效
• 签名外观渲染规则未配置：你设置了setReuseAppearance(false)即不复用原有字段的外观，需要显式指定签名的渲染模式，否则iText不会生成可见的外观内容，补充以下配置即可：

// 选择合适的渲染模式，比如同时显示签名人姓名和签名说明
appearance.setRenderingMode(PdfSignatureAppearance.RenderingMode.NAME_AND_DESCRIPTION);
// 如果需要显示自定义印章图片，可使用GRAPHIC_AND_NAME模式
// appearance.setRenderingMode(PdfSignatureAppearance.RenderingMode.GRAPHIC_AND_NAME);
// appearance.setSignatureGraphic(ImageFactory.create("印章路径"));

• 字段所在页码和预期不符：如果文档页码不是从1开始、或者签名字段不在第1页，可在设置字段名后调用pdfSigner.getSignatureAppearance().setPageNumber(字段所在页码)显式指定。

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