Node.js环境下为PDF添加图形签名、数字签名及时间戳问题咨询

根因说明 #

pdf-lib默认保存配置会重构PDF底层结构：启用useObjectStreams参数时会生成流式交叉引用表，同时默认会清理原始PDF的trailer自定义字段，如果你的后续数字签名逻辑依赖旧式Xref表或者原始trailer的特定属性，就会触发Xref未定义报错。 #

可行解决方案 #

方案1：调整pdf-lib保存参数（改造成本最低，优先推荐） #

加载和保存PDF时添加以下配置，强制保留原有结构特征：

// 加载原始PDF
const pdfDoc = await PDFDocument.load(originalPdfBuffer, {
  ignoreEncryption: true // 若原始PDF无加密可移除该参数
})

// 此处插入你添加带Signage时间戳文本的业务逻辑
// ...

// 导出修改后的PDF
const modifiedPdfBuffer = await pdfDoc.save({
  useObjectStreams: false, // 禁用对象流，生成旧式Xref表
  compress: false, // 禁用内容压缩，避免结构被改写
  preserveTrailer: true // 完整保留原始PDF的trailer字段
})

90%以上的同类结构兼容问题可以通过该配置直接修复。 #

方案2：手动修复trailer字段 #

如果调整参数后仍有报错，可手动比对修改前后的PDF trailer，补充签名逻辑依赖的属性：

// 读取原始trailer的指定属性（示例为读取/Info字段引用）
const originalInfoRef = pdfDoc.context.lookup(
  pdfDoc.context.trailerInfo.get(PDFName.of('Info'))
)
// 写入新的trailer
pdfDoc.context.trailerInfo.set(PDFName.of('Info'), originalInfoRef)

修改完成后可先通过PDF结构校验工具验证Xref和trailer的合法性，再传入后续签名流程。 #

方案3：替换文本添加依赖库 #

如果pdf-lib的结构改写逻辑和现有签名链路完全不兼容，可改用hummusjs实现时间戳文本添加，该库默认采用增量更新模式修改PDF，不会改写原有Xref和trailer结构，完全适配后续数字签名的结构完整性要求。 #

注意：所有数字签名前的PDF修改操作建议尽量采用增量更新模式，不要重构PDF整体结构，避免破坏签名所需的结构哈希一致性。

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