使用Node.js验证已签名PDF文档电子签名的问题求助

问题根因 #

@ninja-labs/verify-pdf返回undefined、报VerifyPDFError: Failed byte range verification错误的核心原因是该包已停止维护超过3年，仅适配非常老旧的单签名未压缩PDF，不支持符合PAdES标准的签名、PDF增量更新后的多重签名、签名信息存放在PDF尾部交叉引用流的场景，无法覆盖大部分生产环境的签名PDF验证需求。

可行解决方案 #

方案1：使用@signpdf/verify包（纯Node.js实现，无需依赖外部工具） #

该包是目前维护活跃的PDF签名验证工具，支持大部分主流签名规范，可直接提取签名证书的issuedTo等核心信息。
安装命令：

npm install @signpdf/verify @signpdf/utils

代码示例：

const fs = require('fs');
const { verifySignature } = require('@signpdf/verify');

const signedPdfBuffer = fs.readFileSync('signed.pdf');

async function runVerify() {
  const result = await verifySignature(signedPdfBuffer);
  // 核心返回字段说明
  // result.verified：整体验证是否通过
  // result.integrityVerified：文档是否未被篡改
  // result.certificateValid：签名证书是否合法
  // result.notExpired：证书是否在有效期内
  // result.signatures：所有签名的明细列表，包含issuedTo、证书有效期等字段
  console.log('验证结果：', result);
}

runVerify();

方案2：调用poppler工具集的pdfsig（兼容性最高，适配所有标准签名PDF） #

该方案适合对验证准确率要求极高的场景，pdfsig是poppler官方提供的PDF签名验证工具，兼容所有符合PDF32000标准的签名文档，不会出现字节范围校验错误问题。
操作步骤：

• 先安装poppler工具集：
  • Debian/Ubuntu系统执行 apt install poppler-utils
  • macOS系统执行 brew install poppler
  • Windows系统下载官方编译包并添加到系统环境变量
• Node.js调用代码示例：

const { execFile } = require('child_process');

const pdfPath = 'signed.pdf';

execFile('pdfsig', ['-json', pdfPath], (error, stdout, stderr) => {
  if (error) {
    console.error('验证失败：', error);
    return;
  }
  const verifyResult = JSON.parse(stdout);
  // 返回结果包含所有签名的验证状态、证书信息、篡改检测结果等全量数据
  console.log('验证结果：', verifyResult);
});

方案3：基于pdf-lib + node-forge自定义实现（适合定制化校验场景） #

如果有特殊的业务校验逻辑，可以通过pdf-lib解析PDF的签名字典，提取签名内容和字节范围，再用node-forge完成证书校验和签名验签，实现高度定制化的验证逻辑。

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