Node.js调用node-7z解压文件时报spawn 7z ENOENT错误如何解决？

错误产生原因 #

• 报错中的ENOENT是操作系统层面的错误，含义为“找不到对应文件/目录”，结合日志中的spawn 7z字段可知：node-7z仅为7-Zip程序的Node.js封装库，本身不携带7-Zip二进制执行文件，你的运行环境中未安装7-Zip，或是安装后未将7-Zip的执行路径加入系统PATH环境变量，导致Node.js创建子进程调用7z命令时无法定位到可执行文件。

修复方案 #

1. 安装7-Zip到运行环境 #

根据你使用的操作系统选择对应安装方式：

• Linux（Debian/Ubuntu 系）：执行命令 sudo apt install p7zip-full p7zip-rar
• Linux（CentOS/RHEL 系）：执行命令 sudo yum install p7zip p7zip-plugins
• Windows：下载7-Zip安装包安装，安装时勾选「添加7-Zip到系统PATH环境变量」选项，或安装完成后手动将7-Zip安装目录（默认路径为C:\Program Files\7-Zip）加入系统PATH。
• macOS：通过Homebrew执行命令 brew install p7zip

2. 验证环境配置 #

安装完成后先在终端/命令行执行7z命令，若正常输出7-Zip的帮助信息说明环境配置生效，此时重新运行Node.js程序即可解决该报错。

3. 可选：代码内手动指定7z路径 #

如果不想修改全局环境变量，或是运行环境存在多版本7-Zip的情况，可以直接在代码中指定7z可执行文件的绝对路径，示例如下：

const Seven = require('node-7z');
// 按实际7z执行文件路径修改$bin参数
const zipInstance = Seven({
  $bin: '/usr/bin/7z', // Linux/macOS 路径示例
  // $bin: 'C:\\Program Files\\7-Zip\\7z.exe' // Windows 路径示例
});

// 后续解压逻辑使用自定义的zipInstance调用即可
zipInstance.extractFull(
  '/var/somefolder/myfolder/uploads/myfile.zip',
  '/var/somefolder/myfolder',
  {
    password: 'MyPassword',
    y: true,
    bb: 3
  }
).then(() => {
  console.log('解压完成')
}).catch(err => {
  console.error('解压出错', err)
})

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