Node.js Spawn/Exec调用下载脚本无效问题排查

1. 避免拼接命令字符串，改用Spawn分传参数 #

直接拼接命令字符串极易因参数含特殊字符（空格、&、$等）导致解析失败，这是此类问题的高频诱因。使用spawn时分开传递每个参数，无需依赖shell解析：

const fs = require('fs');

downloaderSpawn() {
  const nodeBinary = '/usr/bin/node';
  const childScriptPath = '/home/ebo/downloader.js';
  const logFilePath = `/home/ebo/${this.id}/logfile.txt`;
  
  // 以追加模式打开日志文件
  const logStream = fs.createWriteStream(logFilePath, { flags: 'a' });

  // 拆分参数传递，避免命令解析错误
  const childProcess = spawn(nodeBinary, [childScriptPath, this.id, this.key], {
    detached: true,
    stdio: ['ignore', logStream, logStream] // 将stdout/stderr定向到日志文件
  });

  // 解除主进程对子进程的引用，让子进程可独立后台运行
  childProcess.unref();

  childProcess.on('error', (err) => {
    console.error(`子进程启动失败: ${err.message}`);
  });

  childProcess.on('close', (code) => {
    console.log(`子进程退出，码值: ${code}`);
    logStream.end(); // 关闭日志流
  });
}

2. 检查工作目录与权限 #

• 工作目录差异：手动执行时的终端工作目录和Express进程的cwd可能不同，如果downloader.js用到相对路径，需在spawn选项中显式设置工作目录：

  spawn(nodeBinary, [...], {
    cwd: '/home/ebo', // 设为downloader.js所在目录
    // 其他选项
  });
  

• 权限问题：确保Express运行用户（如www-data）拥有：
  • 读取/home/ebo/downloader.js的权限
  • 读写/home/ebo/${this.id}目录的权限
    可通过以下命令调整：

  sudo chown -R www-data:www-data /home/ebo
  sudo chmod -R 755 /home/ebo
  

3. 排查环境变量差异 #

终端运行时的环境变量（如NODE_PATH、系统PATH）可能与Express进程不同，导致downloader.js依赖加载失败。可在spawn中继承主进程环境，或显式添加所需变量：

spawn(nodeBinary, [...], {
  env: { ...process.env, NODE_PATH: `${process.env.NODE_PATH}:/home/ebo/node_modules` },
  // 其他选项
});

4. 捕获启动阶段错误 #

之前的代码仅监听close事件，添加error事件监听可捕获进程启动失败的具体原因（如node二进制路径错误、脚本文件不存在）：

childProcess.on('error', (err) => {
  console.error(`子进程启动出错: ${err.stack}`);
});

5. 验证路径与参数正确性 #

启动子进程前打印所有路径和参数，确认无拼写错误：

console.log(`Node路径: ${nodeBinary}`);
console.log(`脚本路径: ${childScriptPath}`);
console.log(`参数: id=${this.id}, key=${this.key}`);
console.log(`日志路径: ${logFilePath}`);

内容的提问来源于stack exchange，提问作者Random Code Guy