Nodejs通过子进程执行unzip命令报错但终端执行正常问题咨询

问题原因&解决方案 #

1. 子进程工作目录不匹配 #

Node.js exec 方法默认的工作目录是Node进程的启动目录，而非脚本文件所在的目录。你在终端手动执行unzip时处于zip文件的存放目录，能正常找到文件，但子进程执行时大概率找错了路径，读取到的是空文件/不存在的文件，就会触发该报错。

• 排查方法：在调用unzip前打印当前工作目录和文件信息确认：

const fs = require('fs')
console.log('当前工作目录：', process.cwd())
console.log('文件是否存在：', fs.existsSync('./recentDatabase.zip'))
console.log('文件大小：', fs.statSync('./recentDatabase.zip').size)

• 解决方法：给exec手动指定工作目录到zip文件所在路径：

exec("unzip recentDatabase.zip", {cwd: '/你的/zip文件/所在目录路径'}, (error, stdout, stderr) => {
  // 原有逻辑
})

2. 下载文件的写流未完全关闭 #

你提到已经确认HTTP下载完成后才执行解压，但如果是监听HTTP响应的end事件就触发解压，此时写入文件的流可能还没把所有内容刷入磁盘、没有释放文件句柄，子进程读取到的是不完整的zip文件。

• 解决方法：监听文件写流的close事件后再执行解压：

const writeStream = fs.createWriteStream('recentDatabase.zip')
http.get(下载链接, res => {
  res.pipe(writeStream)
  // 不要监听res的end事件，要等写流完全关闭
  writeStream.on('close', () => {
    // 在此处调用unzip逻辑
  })
})

3. 权限差异 #

你终端执行命令用的是当前登录用户，而运行Node脚本的用户可能是其他低权限用户（比如www-data、nobody等），没有zip文件的读取权限，也会导致unzip无法正常读取文件内容报该错误。

• 排查方法：在exec中先执行ls命令确认子进程视角的文件权限：

exec("ls -la recentDatabase.zip", (err, stdout) => {
  console.log('子进程读取的文件信息：', stdout)
})

• 解决方法：给Node运行用户授予zip文件的读权限，或者给对应目录的读写权限。

4. unzip程序路径不匹配 #

子进程的shell环境变量和你终端的环境变量可能不一致，调用的不是同一个unzip程序，也可能出现兼容问题。

• 解决方法：先在终端执行which unzip拿到unzip的绝对路径（比如/usr/bin/unzip），替换exec中的命令为绝对路径：

exec("/usr/bin/unzip recentDatabase.zip", {cwd: '你的目录'}, (error, stdout, stderr) => {
  // 原有逻辑
})

额外建议：后续的删除旧文件、重命名逻辑最好增加解压成功的判断，避免解压失败导致旧数据被误删。

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