JavaScript使用lz4库解压LZ4压缩字节数组得到全零或魔数错误问题求助

1 第一版代码的核心错误 #

你写的第一版代码完全没有把压缩数据传入解码方法：

// 你虽然读取了压缩数据到input变量
var input = Buffer.from(this.bytes);
var output = Buffer.alloc( lz4.encodeBound(input.length) );
var uncompressed = Buffer.alloc(input.length);
// 但decodeBlock第一个参数传的是空的output，根本没传入压缩后的input数据
var uncompressedSize = lz4.decodeBlock(output, uncompressed);

压缩数据没有被传入解码逻辑，自然返回全零数组。

2 LZ4.decode报错的原因 #

LZ4.decode方法仅支持解码*带标准LZ4文件头（包含magic number标识）*的完整压缩文件/流，你手里的是无文件头的原始LZ4压缩块，没有对应标识，调用这个方法自然会报magic number错误。
另外你把字节数组用join("")转成字符串再传入的操作也是错误的，解码需要原始二进制Buffer，不能转成字符串格式。

3 最终正确实现步骤 #

前置注意点 #

• 原始LZ4块解码需要你提前预留足够大的输出Buffer，避免解压时空间不足，如果你不知道原始数据大小，可按常见压缩比1:20预留（可根据你的实际数据调整）
• node-lz4的decodeBlock方法参数顺序为：(压缩数据Buffer, 输出解压Buffer, [压缩数据起始偏移])，返回值为解压后的实际字节长度，返回0代表解码失败
• 确认你传入的压缩数据Buffer是正确的原始压缩字节，不要传错变量

正确示例代码 #

// 第一步：将压缩字节数组转为Buffer
const compressedBuf = Buffer.from(this.bytes);
// 第二步：分配足够大的输出Buffer
const maxUncompressSize = compressedBuf.length * 20;
const uncompressBuf = Buffer.alloc(maxUncompressSize);
// 第三步：调用decodeBlock解码
const uncompressSize = lz4.decodeBlock(compressedBuf, uncompressBuf);
if (uncompressSize <= 0) {
  throw new Error('LZ4块解码失败，请确认压缩数据格式正确性');
}
// 第四步：截取有效长度的解压数据
const result = uncompressBuf.slice(0, uncompressSize);
console.log('解压结果：', result);

额外排查方向 #

如果运行上述代码还是返回0或者无效数据，确认以下两点：

• 你的压缩数据是不是带了自定义的头部偏移？如果是，你需要给decodeBlock传第三个参数，指定压缩数据在Buffer里的起始偏移位
• 确认你的数据确实是标准LZ4压缩的原始块，而不是其他压缩算法或者LZ4变种格式（比如LZ4HC、带校验和的LZ4块等）

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