iText5为仅含图片的PDF添加可见签名不显示问题如何解决

问题根因 #

1. 页面旋转属性适配缺失：仅含图片的PDF（多为扫描件、图片导出生成）通常会携带页面旋转参数（Rotate属性，常见为90°/180°/270°），你当前代码中传入setVisibleSignature的矩形坐标是基于页面原始坐标系计算的，未适配旋转后的可视坐标系，最终签名块被渲染到页面可视区域之外，因此用户看不到也无法点击，但签名字段本身已被正确写入PDF结构，所以Acrobat可以识别到签名容器。
2. 页面裁剪框适配缺失：部分图片导出的PDF会设置不同的MediaBox（页面定义尺寸）和CropBox（实际显示裁剪尺寸），如果签名坐标仅参考MediaBox计算，可能落在CropBox之外的裁剪区域，导致无法显示。
3. 图层渲染顺序异常：部分图片PDF的页面内容流层级覆盖了签名字段的默认渲染层级，导致签名块被底图遮挡。

解决方法 #

• 坐标适配：签名前先获取目标页面的旋转角度、MediaBox、CropBox参数，将预设的签名坐标转换为适配当前页面可视区域的实际坐标：

// originalRect为你原本计算的签名位置矩形new Rectangle(c[0], c[1], c[2], c[3])
int pageRotation = reader.getPageRotation(pageNum);
Rectangle pageMediaBox = reader.getMediaBox(pageNum);
Rectangle adjustedRect;
// 按旋转角度转换坐标，其他角度可对应调整转换逻辑
if (pageRotation == 90) {
    adjustedRect = new Rectangle(
        pageMediaBox.getHeight() - originalRect.getTop(),
        originalRect.getLeft(),
        pageMediaBox.getHeight() - originalRect.getBottom(),
        originalRect.getRight()
    );
} else if (pageRotation == 180) {
    adjustedRect = new Rectangle(
        pageMediaBox.getWidth() - originalRect.getRight(),
        pageMediaBox.getHeight() - originalRect.getTop(),
        pageMediaBox.getWidth() - originalRect.getLeft(),
        pageMediaBox.getHeight() - originalRect.getBottom()
    );
} else if (pageRotation == 270) {
    adjustedRect = new Rectangle(
        originalRect.getBottom(),
        pageMediaBox.getWidth() - originalRect.getRight(),
        originalRect.getTop(),
        pageMediaBox.getWidth() - originalRect.getLeft()
    );
} else {
    adjustedRect = originalRect;
}
// 用调整后的坐标设置可见签名
appearance.setVisibleSignature(adjustedRect, pageNum, field);

• 强制签名图层优先级：显式指定渲染模式，设置签名字段属性确保签名层在页面内容之上渲染：

// 显式指定渲染模式
appearance.setRenderingMode(PdfSignatureAppearance.RenderingMode.GRAPHIC_AND_TEXT);
// 设置签名字段顶层显示、可打印
PdfFormField sigField = appearance.getSigField();
sigField.setFieldFlags(PdfFormField.FF_REQUIRED);
sigField.setFlags(PdfAnnotation.FLAGS_PRINT | PdfAnnotation.FLAGS_LOCKED);

• 兼容低版本iText缺陷：如果你使用的是iText 5.x版本，额外调用stamper.setRotateContents(false)避免页面内容旋转时连带签名坐标被二次偏移。

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