如何保障pdfmake生成PDF的完整性？无磁盘生成哈希方案

1. 流式计算SHA256哈希（无需写入磁盘） #

Node.js的crypto模块支持流式哈希计算，我们可以把PDF生成的数据流同时导向响应对象和哈希计算流，实时完成哈希计算，不需要把整个PDF加载到内存或写入磁盘。

修改后的代码示例：

const crypto = require('crypto');
module.exports = async function (res) {
  // ... 你的docDefinition构建逻辑

  const pdfDoc = printer.createPdfKitDocument(docDefinition);
  // 初始化SHA256哈希流
  const hash = crypto.createHash('sha256');

  // 监听PDF数据流，实时更新哈希
  pdfDoc.on('data', (chunk) => {
    hash.update(chunk);
  });

  // PDF流结束时生成最终哈希值，可通过响应头返回给客户端
  pdfDoc.on('end', () => {
    const sha256Hash = hash.digest('hex');
    res.setHeader('X-PDF-SHA256', sha256Hash);
    // 也可将哈希值通过接口返回体、下载链接参数等方式传递
  });

  // 将PDF流管道到响应对象，供客户端下载
  pdfDoc.pipe(res);
  pdfDoc.end();
};

2. 完整性验证方法 #

前端浏览器验证 #

使用浏览器原生的crypto.subtle API计算下载文件的哈希，与服务端返回的哈希值对比：

async function verifyPdfIntegrity(file, expectedHash) {
  const arrayBuffer = await file.arrayBuffer();
  const hashBuffer = await crypto.subtle.digest('SHA-256', arrayBuffer);
  
  // 将哈希结果转为十六进制字符串
  const hashArray = Array.from(new Uint8Array(hashBuffer));
  const computedHash = hashArray.map(b => b.toString(16).padStart(2, '0')).join('');
  
  return computedHash === expectedHash.toLowerCase();
}

// 使用示例
verifyPdfIntegrity(downloadedFile, serverReturnedHash)
  .then(isValid => {
    if (isValid) {
      console.log('PDF完整，未被篡改');
    } else {
      console.log('PDF已被篡改，验证失败');
    }
  });

Node.js环境验证（如后端验证上传的PDF） #

同样用crypto模块流式计算哈希对比：

const crypto = require('crypto');
const { createReadStream } = require('fs');

async function verifyPdfIntegrity(filePath, expectedHash) {
  const hash = crypto.createHash('sha256');
  const fileStream = createReadStream(filePath);

  return new Promise((resolve, reject) => {
    fileStream.on('data', chunk => hash.update(chunk));
    fileStream.on('end', () => {
      const computedHash = hash.digest('hex');
      resolve(computedHash === expectedHash.toLowerCase());
    });
    fileStream.on('error', reject);
  });
}

关键注意事项 #

• 哈希值的传递要保证安全：建议通过HTTPS响应头、签名后的接口返回体（如JWT）传递，避免中间人篡改哈希值。
• 始终用流式处理：避免将大PDF加载到内存计算哈希，防止内存溢出。

内容的提问来源于stack exchange，提问作者Rene J. Martins