Node.js Lambda中2GB以上PGP加密大文件解密失败求助

问题背景 #

在S3存储桶中存储了若干PGP加密二进制文件，使用Node.js Lambda函数解密时，小于2GB的文件正常解密，但大于2GB的特定来源文件解密失败；另一来源的2.5GB文件则可正常解密。Lambda已配置最高规格（10GB内存+10GB存储）。

实现代码 #

const fileStream = fs.createReadStream(encryptedFile);
const message = await openpgp.readMessage({
  binaryMessage: fileStream // parse armored message
});
const { data: decrypted, signatures } = await openpgp.decrypt({
  message,
  format: 'binary',
  decryptionKeys: privateKey,
  config: { allowUnauthenticatedStream: true, preferredCompressionAlgorithm: openpgp.enums.compression.zlib }
});

报错信息 #

"[ERROR] Message: Error decrypting message: Cannot read the properties of undefined (reading 'length')"

调试观察结果 #

• 程序能成功解析加密消息，但在解密步骤触发错误
• 读取消息完成后，约4分钟才抛出该错误
• 仅特定来源的大文件出现此问题，其他来源的2.5GB文件解密正常

可能原因分析 #

1. 加密文件结构不规范：特定来源的大文件可能采用了非标准的PGP分段加密策略，openpgp.readMessage仅校验了头部格式通过，但解密时处理深层分块数据时，某段数据未正确初始化length属性，导致报错。
2. 流处理的边界异常：大文件解密时，流缓冲在处理特定文件的某个节点出现数据截断或未正确初始化的缓冲区，触发length属性读取失败。
3. 库版本兼容性问题：当前使用的openpgp库版本，与特定来源文件采用的PGP加密特性存在兼容性bug，仅在处理大文件时暴露。

加密文件完整性验证方法 #

• 本地GnuPG测试：将有问题的大文件下载到本地，执行gpg --decrypt your-large-file.pgp，如果本地解密失败，说明文件本身加密结构存在问题；如果本地成功，问题则出在Lambda环境或代码流处理逻辑。
• 哈希值校验：对比加密文件的MD5/SHA256哈希值与源端提供的哈希值，确认文件在S3传输、存储过程中未损坏。
• 分段定位测试：将大文件分割为多个小分段，逐个用现有代码解密，定位是哪个分段触发的错误，缩小问题范围。

大文件解密的关键优化点 #

• 显式启用流式解密：如果使用的openpgp版本支持，在decrypt配置中添加stream: true，直接返回解密流而非缓冲全部数据，避免内存溢出或结构异常。
• 调整Lambda超时：将Lambda执行超时设置为最大值（15分钟），避免大文件解密过程中因超时被强制终止。
• 调整openpgp版本：尝试升级到最新版openpgp，或降级到与加密源端兼容的版本，排查版本特性差异导致的问题。
• 简化配置测试：暂时关闭allowUnauthenticatedStream（业务允许的前提下），或更换压缩算法配置，排查是否是这些配置与特定加密文件不兼容。

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