使用Node.js zlib解压文件时出现incorrect header check错误如何解决？

问题原因 #

ZIP是包含文件元数据的容器格式，即便你用DEFLATE算法压缩，ZIP文件依然会包裹一层包含文件头、文件名、额外字段等信息的容器结构。而zlib.createGunzip()仅能处理gzip格式的压缩流，无法识别ZIP的容器结构，因此触发头部校验错误。

解决方案（仅使用内置模块） #

由于你的ZIP仅包含单个文件，可通过手动解析ZIP本地文件头，提取出纯DEFLATE压缩数据后再用zlib解压，代码如下：

const fs = require('fs');
const zlib = require('zlib');
const path = require('path');

const zipFilePath = path.join(__dirname, 'test.zip');
const unzipDir = path.join(__dirname, 'unzipdir');
// 若不确定文件名，可从ZIP头中读取，这里假设已知输出文件名
const outputFilePath = path.join(unzipDir, 'output.txt');

// 确保输出目录存在
if (!fs.existsSync(unzipDir)) {
  fs.mkdirSync(unzipDir);
}

fs.readFile(zipFilePath, (err, zipBuffer) => {
  if (err) {
    console.error('读取ZIP文件失败:', err);
    return;
  }

  // 验证ZIP本地文件头签名（0x504B0304）
  const headerSignature = zipBuffer.readUInt32LE(0);
  if (headerSignature !== 0x504B0304) {
    console.error('无效的ZIP文件');
    return;
  }

  // 验证压缩方法为DEFLATE（值为8）
  const compressionMethod = zipBuffer.readUInt16LE(8);
  if (compressionMethod !== 8) {
    console.error('不支持当前压缩方法');
    return;
  }

  // 读取文件名长度和额外字段长度
  const fileNameLength = zipBuffer.readUInt16LE(26);
  const extraFieldLength = zipBuffer.readUInt16LE(28);

  // 计算压缩数据的起始位置：本地头(30字节) + 文件名长度 + 额外字段长度
  const compressedStart = 30 + fileNameLength + extraFieldLength;
  // 提取纯DEFLATE压缩数据
  const compressedData = zipBuffer.slice(compressedStart);

  // 使用zlib.inflate解压DEFLATE格式数据
  zlib.inflate(compressedData, (err, uncompressedData) => {
    if (err) {
      console.error('解压失败:', err);
      return;
    }

    // 写入解压后的文件
    fs.writeFile(outputFilePath, uncompressedData, (err) => {
      if (err) {
        console.error('写入文件失败:', err);
        return;
      }
      console.log('解压完成');
    });
  });
});

说明 #

• 该方法仅适用于单文件、无加密、无复杂扩展字段的简单ZIP文件
• 如果需要处理多文件或复杂ZIP结构，Node.js标准库没有提供完整的ZIP解析能力，此时建议使用第三方模块（如adm-zip），但如果你严格要求只用内置模块，需要进一步完善ZIP目录结构的解析逻辑

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