如何借助iTextPdf的IExternalSignatureContainer将PDF的ByteRange移至末尾？

要让包含ByteRange的签名字典位于PDF文件末尾，核心是使用增量更新方式签署PDF，而非直接修改原文件主体内容。你修改modifySigningDictionary方法无效，是因为该方法仅负责调整签名字典的内容（比如SubFilter、签名者信息等），无法改变字典在PDF文件中的存储位置。

关键解决方案 #

无论使用iText 5还是iText 7，都需要依赖框架提供的签名专用类实现增量更新，确保签名相关内容被追加到文件末尾：

1. iText 7 实现示例

// 读取原PDF
PdfReader reader = new PdfReader("待签名PDF路径");
// 输出流指向签名后的文件
FileOutputStream os = new FileOutputStream("签名后PDF路径");
// 创建PdfSigner并明确指定增量模式（默认也是增量，显式声明更稳妥）
PdfSigner signer = new PdfSigner(reader, os, new StampingProperties().useAppendMode());

// 实例化你实现的签名容器
IExternalSignatureContainer signatureContainer = new CustomExternalSignatureContainer();
// 执行签名，8192为签名占位符大小（可根据实际签名长度调整）
signer.signExternalContainer(signatureContainer, 8192);

你的签名容器实现：

class CustomExternalSignatureContainer implements IExternalSignatureContainer {
    @Override
    public byte[] sign(InputStream data) throws GeneralSecurityException {
        // 这里实现签名逻辑：对输入流data计算并返回签名字节数组
        return generateSignature(data);
    }

    @Override
    public void modifySigningDictionary(PdfDictionary signDic) {
        // 仅在此调整签名字典的内容，比如设置签名类型
        signDic.put(PdfName.SubFilter, PdfName.AdbePKCS7Detached);
        // 可添加其他签名属性，如签名者名称、位置等
    }
}

2. iText 5 实现示例

PdfReader reader = new PdfReader("待签名PDF路径");
FileOutputStream os = new FileOutputStream("签名后PDF路径");
// 创建PdfStamper时开启append模式（最后一个参数true），确保增量更新
PdfStamper stamper = PdfStamper.createSignature(reader, os, '\0', null, true);

// 配置签名外观（可选）
PdfSignatureAppearance appearance = stamper.getSignatureAppearance();
appearance.setReason("文档签名");
appearance.setLocation("XX位置");

// 实例化签名容器并执行签名
ExternalSignatureContainer container = new CustomExternalSignatureContainer();
MakeSignature.signExternalContainer(appearance, container, 8192);

对应的iText 5签名容器实现：

class CustomExternalSignatureContainer implements com.itextpdf.text.pdf.security.IExternalSignatureContainer {
    @Override
    public byte[] sign(InputStream data) throws GeneralSecurityException {
        return generateSignature(data);
    }

    @Override
    public void modifySigningDictionary(PdfDictionary signDic) {
        signDic.put(PdfName.SUBFILTER, PdfName.ADBE_PKCS7_DETACHED);
    }
}

为什么之前的ByteRange在头部？ #

如果签名字典（包含ByteRange）出现在文件头部，大概率是因为你没有使用增量更新模式，而是直接修改了原PDF的主体结构（比如用普通的PdfDocument编辑后保存），导致签名字典被插入到PDF的核心内容区域，而非末尾的增量更新段。

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