NodeJS并行运行npm脚本时spawn触发ENOENT错误求助

尝试用Node.js的child_process.spawn并行运行3个npm脚本（如npm run x-script），并将子进程输出流到父进程，但触发以下错误：

node:events:491

throw er; // Unhandled 'error' event

Error: spawn npm run debug-js-watch ENOENT

• at Process.ChildProcess._handle.onexit (node:internal/child_process:283:19)
• at onErrorNT (node:internal/child_process:478:16)
• at processTicksAndRejections (node:internal/process/task_queues:83:21)
  Emitted 'error' event on ChildProcess instance at:
• at Process.ChildProcess._handle.onexit (node:internal/child_process:289:12)
• at onErrorNT (node:internal/child_process:478:16)
• at processTicksAndRejections (node:internal/process/task_queues:83:21)

{
  errno: -4058,
  code: 'ENOENT',
  syscall: 'spawn npm run debug-js-watch',
  path: 'npm run debug-js-watch',
  spawnargs: []
}

当前代码：

const path = require('path');
const { spawn } = require('node:child_process');

function runInParallel(command, argumentsList) {
    let childProcess = spawn(command, argumentsList);
    childProcess.stdout.on('data', (data) => {
        console.log(data.toString());
    });

    childProcess.stderr.on('data', (data) => {
        console.error(data.toString());
    });

    /*
    childProcess.on('exit', (code) => {
        console.log(`Child exited with code ${code}`);
    });
    */
}

runInParallel('npm run debug-js-watch', []);
runInParallel('npm run debug-css-watch', []);
runInParallel('npm run debug-serve', []);

错误原因 #

spawn的第一个参数是可执行文件的路径/名称，第二个参数是传递给该可执行文件的参数数组。你把整个npm run xxx作为第一个参数，Node会把它当作一个单独的可执行文件去查找，自然找不到，触发ENOENT错误。

修正代码 #

将命令拆分为可执行文件和参数两部分，同时添加error事件监听避免未处理错误，还可以给每个子进程的输出加上标识，方便区分来源：

const { spawn } = require('node:child_process');

function runInParallel(command, args, label) {
    const childProcess = spawn(command, args);
    
    // 给输出加上脚本标识，方便区分来源
    childProcess.stdout.on('data', (data) => {
        console.log(`[${label}] ${data.toString().trim()}`);
    });

    childProcess.stderr.on('data', (data) => {
        console.error(`[${label}] ${data.toString().trim()}`);
    });

    // 监听error事件，避免未处理异常导致进程崩溃
    childProcess.on('error', (err) => {
        console.error(`[${label}] 启动失败: ${err.message}`);
    });

    childProcess.on('exit', (code) => {
        console.log(`[${label}] 退出，代码: ${code}`);
    });
}

// 拆分命令：第一个参数是npm，第二个是参数数组
runInParallel('npm', ['run', 'debug-js-watch'], 'JS Watch');
runInParallel('npm', ['run', 'debug-css-watch'], 'CSS Watch');
runInParallel('npm', ['run', 'debug-serve'], 'Serve');

额外说明 #

• 如果是Windows环境，某些情况下可能需要指定npm.cmd作为可执行文件，但通常Node会自动处理环境变量中的可执行文件，直接用npm即可。
• 若要确保跨平台兼容性，可以通过process.platform判断系统，动态调整可执行文件名称：

  const npmExecutable = process.platform === 'win32' ? 'npm.cmd' : 'npm';
  

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