如何使用Node.js Zlib在内存中解压带文件结构的Zip响应Buffer

Node.js 内置的 zlib 模块仅支持处理原始的 deflate/gzip 压缩数据流，无法直接识别 ZIP 归档格式的文件结构。ZIP 归档除了压缩后的文件内容外，还包含文件头、中央目录、校验信息等元数据结构，直接把完整的 ZIP Buffer 传给 zlib.unzipSync 自然会报头校验错误。

你可以手动解析 ZIP 归档的结构，提取出目标文件对应的压缩流，再用 zlib 完成解压，全程不需要写入文件系统：

const zlib = require('zlib');

/**
 * 从内存ZIP Buffer中提取指定文件的内容
 * @param {Buffer} zipBuffer 完整的ZIP文件Buffer
 * @param {string} targetFileName 要提取的目标文件名
 * @returns {Buffer} 解压后的文件内容
 */
function extractFileFromZip(zipBuffer, targetFileName) {
  let offset = 0;
  // 遍历ZIP归档中的所有局部文件头
  while (offset < zipBuffer.length) {
    // 局部文件头固定签名为 0x04034b50
    const signature = zipBuffer.readUInt32LE(offset);
    if (signature !== 0x04034b50) break; // 遍历到中央目录区域即可终止

    // 读取头部元字段
    const compressionMethod = zipBuffer.readUInt16LE(offset + 8);
    const compressedSize = zipBuffer.readUInt32LE(offset + 18);
    const fileNameLength = zipBuffer.readUInt16LE(offset + 26);
    const extraFieldLength = zipBuffer.readUInt16LE(offset + 28);

    // 读取当前条目的文件名
    const fileName = zipBuffer.toString('utf8', offset + 30, offset + 30 + fileNameLength);
    // 计算压缩数据的起始偏移量
    const compressedDataOffset = offset + 30 + fileNameLength + extraFieldLength;
    // 提取当前条目的压缩数据
    const compressedData = zipBuffer.slice(compressedDataOffset, compressedDataOffset + compressedSize);

    // 匹配到目标文件则执行解压
    if (fileName === targetFileName) {
      // 8表示deflate压缩，ZIP内的deflate为无包头的原始流，需用inflateRawSync解压
      if (compressionMethod === 8) {
        return zlib.inflateRawSync(compressedData);
      }
      // 0表示未压缩，直接返回原始数据
      else if (compressionMethod === 0) {
        return compressedData;
      }
      throw new Error(`不支持的压缩类型：${compressionMethod}`);
    }

    // 偏移跳到下一个文件头位置
    offset = compressedDataOffset + compressedSize;
  }
  throw new Error(`未找到目标文件：${targetFileName}`);
}

// 调用示例，直接拿到foo.csv的解压内容
const unzipArray = extractFileFromZip(data, 'foo.csv');

上述实现为简化版本，仅适配无加密、无分卷的标准ZIP归档，足够覆盖当前使用场景。如果需要支持中文文件名、数据描述符、加密归档等复杂特性，可基于ZIP格式规范扩展上述逻辑，也可直接使用adm-zip等纯JS ZIP处理库，这类库内部同样基于zlib实现，原生支持纯内存操作。

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