如何使用PDFBox移除电子签名PDF元数据且不使签名失效？

核心结论 #

可以在不使电子签名失效的前提下移除PDF的非签名相关元数据，saveIncremental是实现该需求的关键方法——因为增量保存只会在原有PDF文件末尾追加修改内容，不会改动电子签名覆盖的字节范围，从而保证签名的有效性。

关键注意事项 #

• 不可移除与签名强相关的元数据：包括签名字典（/Sig）、签名的字节范围定义（/ByteRange）、签名验证所需的证书链等，修改这些必然导致签名失效。
• 可安全移除的元数据：文档信息字典（DocumentInformation）中的标题、作者、创建者、修改日期等字段，以及XMP元数据（/Metadata）、文件附件里的非签名相关元数据等。

实用实现步骤与代码示例 #

以下是基于PDFBox的可运行代码（遵循Apache License 2.0）：

import org.apache.pdfbox.pdmodel.PDDocument;
import org.apache.pdfbox.pdmodel.PDDocumentInformation;
import org.apache.pdfbox.pdmodel.common.PDMetadata;
import org.apache.pdfbox.pdmodel.common.filespecification.PDComplexFileSpecification;
import org.apache.pdfbox.pdmodel.common.filespecification.PDEmbeddedFile;

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;

public class RemoveMetadataWithoutInvalidatingSignature {
    public static void main(String[] args) throws IOException {
        // 加载带签名的PDF文件
        File inputFile = new File("signed-input.pdf");
        File outputFile = new File("signed-output-no-metadata.pdf");

        try (PDDocument document = PDDocument.load(inputFile);
             FileOutputStream fos = new FileOutputStream(outputFile)) {

            // 1. 清空文档信息字典中的所有可编辑字段
            PDDocumentInformation info = document.getDocumentInformation();
            info.setTitle(null);
            info.setAuthor(null);
            info.setCreator(null);
            info.setProducer(null);
            info.setSubject(null);
            info.setKeywords(null);
            info.setCreationDate(null);
            info.setModificationDate(null);

            // 2. 移除XMP元数据
            PDMetadata metadata = document.getDocumentCatalog().getMetadata();
            if (metadata != null) {
                document.getDocumentCatalog().setMetadata(null);
            }

            // 3. 移除嵌入式文件中的非签名元数据（可选，根据需求）
            if (document.getDocumentCatalog().getNames() != null && 
                document.getDocumentCatalog().getNames().getEmbeddedFiles() != null) {
                for (PDComplexFileSpecification fs : document.getDocumentCatalog().getNames().getEmbeddedFiles().getNames().values()) {
                    PDEmbeddedFile embeddedFile = fs.getEmbeddedFile();
                    if (embeddedFile != null) {
                        embeddedFile.setSubtype(null);
                        embeddedFile.setParams(null);
                    }
                }
            }

            // 4. 增量保存，核心操作——保证签名不失效
            document.saveIncremental(fos);
        }
    }
}

额外技巧 #

• 测试验证：操作完成后，用Adobe Acrobat或PDFBox的签名验证工具检查签名状态，确认签名仍显示为“有效”。
• 避免误操作：不要对PDF的页面内容、注释、书签等进行修改，这些操作会改变签名覆盖的字节范围，导致签名失效。
• 版本兼容：确保使用的PDFBox版本与目标PDF的版本兼容（推荐使用最新稳定版，如2.0.x系列）。

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