Java中多页PDF签名及加密后签名无效问题求助

问题原因分析 #

1. 全页签名后验证无效 #

拆分PDF为单页签名再合并的操作会生成全新的PDF文档。每个单页的签名仅对该单页PDF的完整性负责，合并后的整体文档哈希值与签名时的单页哈希完全不同，导致签名验证失败。PDF数字签名的核心是绑定整个文档的完整性，拆分合并操作彻底破坏了这种绑定关系。

2. 签名后加密导致签名无效 #

当前使用PDFBox的document.protect()方法会重新加密并写入整个文档，覆盖了原有签名数据的上下文。签名验证依赖文档内容未被篡改，而加密操作直接修改了文档的字节流，导致签名与文档的哈希绑定关系断裂。

解决方案 #

1. 全页签名优化：直接在原文档增量签名 #

无需拆分PDF，直接在原文档的每一页添加独立签名域，使用iText的**增量更新（Append Mode）**完成多页签名。每次签名仅附加签名数据，不修改原有文档内容，确保所有签名的有效性。

2. 签名后加密优化：增量式加密 #

替换PDFBox的加密实现，使用iText的增量加密API，在签名后的文档末尾附加加密信息，不修改已签名的内容部分，保证签名的完整性不受影响。

修改后的核心代码 #

调整多页签名逻辑（signPdf方法中"All Pages"分支） #

if ("All Pages".equals(pageOption)) {
    File outputFile = new File(destinationFolder, extractBaseFileName(file));
    // 先复制原文件到输出路径，作为签名的基础
    Files.copy(file.toPath(), outputFile.toPath(), StandardCopyOption.REPLACE_EXISTING);
    
    int totalPages;
    // 获取原文档总页数
    try (PdfReader tempReader = new PdfReader(file)) {
        totalPages = new PdfDocument(tempReader).getNumberOfPages();
    }

    for (int pageNum = 1; pageNum <= totalPages; pageNum++) {
        // 每次签名都基于当前最新的文档状态，使用Append Mode
        try (PdfReader reader = new PdfReader(outputFile);
             FileOutputStream os = new FileOutputStream(outputFile)) {
            PdfSigner signer = new PdfSigner(reader, os, new StampingProperties().useAppendMode());
            
            PdfSignatureAppearance appearance = signer.getSignatureAppearance();
            appearance.setReason("Testing")
                    .setLocation("Location")
                    .setPageRect(new Rectangle(350, 40, 200, 100))
                    .setRenderingMode(PdfSignatureAppearance.RenderingMode.DESCRIPTION)
                    .setPageNumber(pageNum);

            String fieldName = "Signature" + pageNum;
            signer.setFieldName(fieldName); // 确保每个签名域名称唯一

            signer.signDetached(digest, pks, chain, null, null, null, 0, PdfSigner.CryptoStandard.CMS);
        }
    }
}

替换加密实现为iText增量加密（addPasswordProtection方法） #

private void addPasswordProtection(File file, String password, File destinationFolder) throws IOException {
    String outputFileName = extractBaseFileName(file);
    File outputFile = new File(destinationFolder, outputFileName);
    
    // 使用iText的增量加密，保留原有签名数据
    try (PdfReader reader = new PdfReader(file);
         PdfWriter writer = new PdfWriter(outputFile, new WriterProperties()
                 .setStandardEncryption(
                         password.getBytes(StandardCharsets.UTF_8),
                         password.getBytes(StandardCharsets.UTF_8),
                         EncryptionConstants.ALLOW_PRINTING | EncryptionConstants.ALLOW_COPY,
                         EncryptionConstants.ENCRYPTION_AES_128 | EncryptionConstants.DO_NOT_ENCRYPT_METADATA))) {
        PdfDocument pdfDoc = new PdfDocument(reader, writer, new StampingProperties().useAppendMode());
        pdfDoc.close();
    }
}

注意事项 #

• 确保所有签名域名称唯一，避免覆盖原有签名域。
• 增量更新模式（Append Mode）是保证签名有效的关键，所有修改操作都必须使用该模式。
• 加密时使用与签名相同的iText库，避免不同PDF处理库的兼容性问题。

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