使用Node.js与StreamZip批量解压文件时内容异常问题排查

你遇到的问题核心在于共享变量引发的异步冲突，以及Promise的错误resolve时机，下面我来逐一拆解并给出修复方案：

1. 共享zip变量导致的实例覆盖 #

你在Promise.all外部声明了let zip: StreamZip，然后在遍历每个ZIP文件时都给这个全局（相对于map循环）的变量赋值新的StreamZip实例。由于JavaScript的异步特性，当entry或ready事件触发时，这个zip变量已经被后续循环的新实例覆盖，最终导致所有解压操作都绑定到了同一个ZIP实例上，所以所有文件都来自第一个压缩包。

修复方式：将zip变量的声明移到每个Promise内部，让每个ZIP文件对应独立的实例，互不干扰。

2. Promise提前resolve的问题 #

当前代码在第一个entry的extract回调里就调用了resolve(entry.name)，这会导致Promise提前进入完成状态，而该ZIP文件的其他条目还未处理完成。不仅如此，多个resolve调用是无效的（Promise状态一旦改变就无法再更新），会导致后续条目的处理不受控制。

修复方式：等待当前ZIP文件的所有条目都解压完成后再resolve，比如监听close事件，或者使用extractAll方法一次性解压所有内容（更简洁）。

修复后的完整代码 #

import path from 'path';
import StreamZip from 'node-stream-zip';

export const unpackZip = async (folder: string) => {
  // 优化异步写法，直接await获取ZIP文件列表
  const zipPath = await getFilesByExtension(folder, ".zip");
  console.log("DEBUG PATH: ", zipPath);

  await Promise.all(zipPath.map((zipFile) => {
    return new Promise<string>((resolve, reject) => {
      // 每个ZIP对应独立的实例，避免变量共享冲突
      const zip = new StreamZip({ storeEntries: true, file: `${folder}/${zipFile}` });

      zip.on('error', function (err) {
        console.error('[ERROR]', err);
        reject(err); // 出错时主动reject，避免Promise挂起
      });

      zip.on('ready', function () {
        console.log(`All entries read for ${zipFile}: ` + zip.entriesCount);
        console.log(zip.entries());

        // 为每个ZIP创建独立解压目录，避免同名文件覆盖
        const extractDir = path.resolve('./tmp', path.basename(zipFile, '.zip'));
        
        // 使用extractAll一次性解压所有内容，简化逻辑
        zip.extractAll(extractDir, (err) => {
          if (err) {
            console.error(`Failed to extract ${zipFile}:`, err);
            reject(err);
          } else {
            console.log(`Successfully extracted ${zipFile} to ${extractDir}`);
            zip.close(); // 解压完成后关闭实例释放资源
            resolve(zipFile); // 整个ZIP处理完成后再resolve
          }
        });
      });
    })
  }));
};

额外优化建议 #

• 为每个ZIP文件创建独立的子目录（用ZIP文件名命名），彻底避免不同压缩包的同名文件互相覆盖。
• 错误处理时记得主动reject Promise，否则Promise.all会忽略错误导致程序无响应。
• 使用path模块的方法处理路径，避免硬编码路径带来的跨平台兼容性问题。

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