Node.js child_process exec回调抛出错误无法被外层catch捕获

需要在网站后端执行命令行调用，命令执行失败时捕获对应错误并抛出自定义错误。先后尝试了两种错误抛出实现：
第一种（监听error事件）：

async function someFunction(): Promise<void> {
  // ...其他逻辑
  const result = exec(`some command`);

  result.on('error', (error) => {
    console.log(error.message);
    throw error;
  });
}

第二种（传入exec回调）：

async function someFunction(): Promise<void> {
  // ...其他逻辑
  exec(`some command`, (error) => {
    if (error) {
      throw error;
    }
  });
}

配套的错误捕获代码如下：

try {
  await someFunction();
} catch (e) {
  // ...错误处理逻辑
  throw new Error('Meaningfull error')
}

上述代码永远无法进入catch块，执行到throw error语句时应用直接终止运行，报错信息如下：

Error: Command failed: some Command: Kommando nicht gefunden. //(Command not found)

    at ChildProcess.exithandler (node:child_process:398:12)
    at ChildProcess.emit (node:events:527:28)
    at ChildProcess.emit (node:domain:475:12)
    at maybeClose (node:internal/child_process:1092:16)
    at Socket.<anonymous> (node:internal/child_process:451:11)
    at Socket.emit (node:events:527:28)
    at Socket.emit (node:domain:475:12)
    at Pipe.<anonymous> (node:net:709:12) {
  code: 127,
  killed: false,
  signal: null,
  cmd: 'some Command'
}
Waiting for the debugger to disconnect...
[nodemon] app crashed - waiting for file changes before starting...

移除错误处理相关逻辑后应用可以正常运行，已知所执行的命令必然运行失败，仅希望正常捕获并处理该错误。

补充尝试1 #

直接在exec调用外层包裹try/catch块：

try {
  exec(`some Command`, (error) => {
    if (error) {
      throw error;
    }
  });
} catch (e) {
  throw e;
}

执行到throw error时应用依然直接崩溃。

补充尝试2 #

使用了基于restify中间件的错误处理器，配置代码如下：

this.restify.on('uncaughtException', function(req, res, route, err) {
  res.send(500, err.message);
});

普通错误抛出逻辑可以被该处理器正常捕获，示例代码：

if (!newUser.course) {
  console.log('no course selected');
  throw new Error('signal/no-course'); // 可以被正常捕获处理
}

try {
  await someFunction(newUser); // someFunction里的错误抛出后直接导致应用崩溃
} catch (e) {
  console.log(e);
  throw new Error('signal/add-user');
}

尝试在所有catch块中添加console.log(error)打印错误信息，没有任何效果。

问题出在异步回调里的throw根本不会被外层的try/catch接住：

• child_process.exec是非阻塞异步API，调用后会立刻返回，不会等命令执行完。你写的someFunction在调用exec之后很快就执行结束，外层await someFunction()对应的try/catch块此时已经跑完退出，根本等不到后面命令出错的时刻。
• 不管是error事件的监听回调，还是传给exec的完成回调，都是命令执行结束后Node.js在后续的事件循环里直接调用的。这时候在回调里throw error，错误不会沿着你写的函数调用栈往上走，会直接抛到全局成为未捕获异常，直接炸掉进程。
• 你在exec外面套try/catch没用也是这个道理：try/catch只能捕获同步执行阶段的错误，exec本身的同步调用是成功的，等回调里真的出错时，try/catch早就执行完了，根本接不住。
• restify的uncaughtException处理器只能接住请求处理链路里的同步错误、或者通过next(err)传递的错误。你这个回调里抛出的错误已经跳出了restify的请求处理上下文，属于进程级未捕获异常，自然也处理不到。

不要在回调/事件监听器里直接throw，把exec包装成Promise，把错误归到Promise的reject链路里，这样外层的await和try/catch就能正常捕获了。
推荐直接用Node.js自带的util.promisify把回调风格的exec转成Promise版本，代码示例：

const { exec } = require('child_process');
const { promisify } = require('util');
const execAsync = promisify(exec);

async function someFunction(): Promise<void> {
  // ...其他逻辑
  try {
    // 等待命令执行完成，出错的话会直接抛到当前async函数的Promise链里
    const { stdout, stderr } = await execAsync(`some command`);
    // 正常逻辑处理stdout
  } catch (error) {
    // 这里的错误可以正常被外层调用someFunction的try/catch捕获
    console.log('命令执行失败:', error.message);
    // 可以直接抛出原错误，或者包装成自定义错误抛出
    throw new Error(`命令执行失败: ${error.message}`);
  }
}

如果你不想用promisify，也可以手动包装Promise，本质逻辑一致：

async function someFunction(): Promise<void> {
  // ...其他逻辑
  return new Promise((resolve, reject) => {
    exec(`some command`, (error, stdout, stderr) => {
      if (error) {
        // 错误走reject，就能被await捕获到
        reject(new Error(`命令执行失败: ${error.message}`));
        return;
      }
      // 正常逻辑处理stdout
      resolve();
    });
  });
}

额外提醒：如果执行的命令输出量很大，不要直接用exec，它会把所有输出存在内存里容易爆内存，这种场景换用spawn并按流处理输出即可，错误捕获逻辑和上面一致，包装成Promise在错误事件里reject就行。

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