xxtea-nodejs解密时Buffer未定义错误：原因及修复方案

问题背景 #

使用xxtea-nodejs包进行加解密操作时，在Node.js 14.17.3环境下，解密函数中的new Buffer(data, 'base64')代码行抛出ReferenceError: Buffer is not defined错误，替换为require('buffer/').Buffer.from()后可正常运行。

new Buffer()与Buffer.from()的核心区别 #

• API状态差异：new Buffer()是Node.js早期的旧API，从Node.js 6.x版本开始就被官方标记为废弃，存在安全风险（比如传入数字时会创建未初始化的内存块，可能泄露内存中的敏感数据）。而Buffer.from()是官方推荐的替代API，输入处理更安全、明确，能避免这类安全问题。
• 全局变量可用性差异：在部分模块环境（如ES模块）或特定配置下，全局作用域中的Buffer变量可能未被自动注入，直接访问会导致未定义错误。而require('buffer/').Buffer是显式从buffer模块加载Buffer类，不受全局变量是否存在的影响。

修复方案 #

1. 替换为官方推荐的Buffer.from() #

直接将报错代码行替换为标准写法：

if (typeof data === 'string') data = Buffer.from(data, 'base64');

如果当前环境全局Buffer不可用，先显式导入：

const { Buffer } = require('buffer');

function decrypt(data, key) {
    if (typeof data === 'string') data = Buffer.from(data, 'base64');
    // 剩余代码保持不变
}

2. 修复或升级依赖包 #

如果报错代码来自xxtea-nodejs包本身：

• 检查该包的最新版本，确认是否已经修复了废弃API的问题，直接升级到最新稳定版。
• 若官方未修复，可自行fork仓库修改代码（替换new Buffer()为Buffer.from()），或向官方提交Issue/PR。

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