iText7生成的PDF可见签名在Chrome中不显示问题排查

我之前处理过类似的场景，本质是Word生成PDF的结构特殊性和Chrome PDF渲染引擎（PDFium）的兼容性差异共同导致的。下面分原因和解决方案详细说明：

核心原因 #

Adobe Reader对非标准PDF结构的容错性远高于Chrome的PDFium引擎，Word“另存为PDF”生成的文档通常存在以下特殊点：

1. 页面的CropBox/MediaBox设置不规范，导致签名矩形被渲染到可视区域外
2. 缺少部分标准PDF资源字典，使得iText添加的签名图层（Layer2）无法被PDFium正确识别
3. Word生成的PDF可能存在自定义页面坐标偏移，导致签名位置计算错误

分步解决方案 #

1. 修正签名矩形的坐标计算 #

先获取页面的实际可视区域，再设置签名位置，避免被页面边界裁剪：

using (PdfReader reader = new PdfReader(new MemoryStream(pdfToSign)))
{
    using (MemoryStream fout = new MemoryStream())
    {
        StampingProperties sp = new StampingProperties();
        sp.UseAppendMode();
        PdfSigner signer = new PdfSigner(reader, fout, sp);
        PdfSignatureAppearance appearance = signer.GetSignatureAppearance();
        
        // 获取第一页的实际可视区域
        PdfPage page = reader.GetPage(1);
        Rectangle mediaBox = page.GetMediaBox();
        Rectangle cropBox = page.GetCropBox() ?? mediaBox; // 若CropBox为空则用MediaBox
        
        // 将签名放在右下角（避开页面内容，确保在可视区域内）
        float signWidth = 200;
        float signHeight = 100;
        Rectangle pr = new Rectangle(
            cropBox.GetRight() - signWidth - 10,  // 右偏移10
            cropBox.GetBottom() + 10,             // 下偏移10
            signWidth, 
            signHeight
        );
        
        appearance.SetPageNumber(1);
        appearance.SetPageRect(pr);
        appearance.SetLayer2Text("Hello world");
        appearance.SetLayer2FontSize(8);
        // 改用NAME_AND_DESCRIPTION模式，提升兼容性
        appearance.SetRenderingMode(PdfSignatureAppearance.RenderingMode.NAME_AND_DESCRIPTION);
        // 嵌入标准字体，避免依赖系统字体
        PdfFont font = PdfFontFactory.CreateFont(StandardFonts.HELVETICA);
        appearance.SetLayer2Font(font);
        
        signer.SignDetached(pks, chain, null, null, null, 0, PdfSigner.CryptoStandard.CMS);
        return fout.ToArray();
    }
}

2. 预处理Word生成的PDF，修复结构问题 #

先通过iText标准化Word生成的PDF结构，再进行签名：

// 预处理步骤：修复Word PDF的页面结构
byte[] PreprocessWordPdf(byte[] wordPdf)
{
    using (PdfReader preReader = new PdfReader(new MemoryStream(wordPdf)))
    using (MemoryStream preOut = new MemoryStream())
    {
        PdfWriter preWriter = new PdfWriter(preOut);
        PdfDocument preDoc = new PdfDocument(preReader, preWriter);
        
        for (int i = 1; i <= preDoc.GetNumberOfPages(); i++)
        {
            PdfPage page = preDoc.GetPage(i);
            // 确保CropBox与MediaBox一致（Word有时会设置不合理的CropBox）
            if (page.GetCropBox() == null || !page.GetCropBox().Equals(page.GetMediaBox()))
            {
                page.SetCropBox(page.GetMediaBox());
            }
            // 确保页面旋转设置正确
            if (page.GetRotation() != 0)
            {
                page.SetRotation(0);
            }
        }
        
        preDoc.Close();
        return preOut.ToArray();
    }
}

// 使用时先预处理，再签名
byte[] processedPdf = PreprocessWordPdf(pdfToSign);
byte[] signedPdf = SingPdfUsingCertificate(cert2, processedPdf);

3. 调整Chrome的PDF显示设置 #

确认Chrome没有禁用签名显示：

• 打开Chrome设置，搜索“PDF”
• 确保**“下载PDF文件而不是在Chrome中打开它们”**未勾选
• 进入“PDF文档”详细设置，确认允许显示注释和签名

验证方案 #

完成上述修改后，重新签名Word生成的PDF，Chrome应该能正常显示可见签名了。如果仍有问题，可以尝试将签名的RenderingMode改为GRAPHIC_AND_DESCRIPTION，同时添加一张简单的图片作为签名背景，进一步提升兼容性。

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