Node.js使用child_process执行嵌套子进程运行Shell脚本失败求助

你现在遇到的“嵌套子进程卡住、看不到报错”，基本是以下几个实打实的问题，没有什么玄学的进程隔离机制：

• 第一个脚本根本没有触发execFile的回调：单独在终端跑脚本没问题，不代表它在Node子进程环境里会正常退出。如果脚本里启动了常驻前台服务、没有正确关闭文件句柄、卡在交互等待步骤，execFile的回调永远不会执行，你自然走不到第二个脚本的逻辑。
• 默认管道缓冲区溢出卡进程：execFile默认只给子进程输出留200KB的内存管道，如果第一个脚本的stdout/stderr输出超过这个大小，Node会直接把子进程挂起，同样不会触发回调，程序就像僵住一样。
• 错误和输出被藏在管道里：你现在的写法里，子进程的所有输出都存在Node的内存管道里，既没实时打到控制台，也没在回调里打印出来，哪怕脚本报错、输出正常，你在终端啥都看不到，就会误以为是“错误飘到父进程看不到”。
• 嵌套逻辑和你的实际需求不匹配：你要的是给服务留30秒初始化时间，但嵌套回调的逻辑是“等第一个脚本完全退出、拿到所有输出之后再跑第二个”——如果第一个脚本是常驻启动服务的，永远不会退出，那第二个脚本永远不会被触发。

你的核心需求是「立即启动第一个脚本，固定等待30秒服务初始化完成后，再启动第二个脚本」，不需要复杂的嵌套回调，用定时器+透出实时日志的方式即可，从根源上解决“看不到输出、进程卡住”的问题：

import { execFile } from 'child_process';

/**
 * 统一封装的shell脚本执行方法，全量透出日志
 * @param {string} scriptPath 脚本路径
 * @param {string} tag 日志标记
 */
const runScript = (scriptPath, tag) => {
  const child = execFile(scriptPath, {
    // 把缓冲区拉到10MB，避免输出量太大卡进程
    maxBuffer: 10 * 1024 * 1024,
    // 直接打通子进程和当前Node的控制台，所有输出实时可见，不需要等回调读取
    stdio: 'inherit'
  }, (err) => {
    if (err) {
      console.error(`[${tag}] 执行失败:`, err.message);
      return;
    }
    console.log(`[${tag}] 执行完成，退出码: ${child.exitCode}`);
  });
  return child;
};

// 立即启动第一个脚本
runScript('./first_script.sh', 'first-script');

// 延迟30秒启动第二个脚本
setTimeout(() => {
  runScript('./second_script.sh', 'second-script');
}, 30 * 1000);

关键配置说明 #

• 为什么设置stdio: 'inherit'：默认配置下，子进程的所有stdout/stderr都会被Node拦到内存管道里，你既不能实时看到输出，一旦缓冲区满还会把进程卡死。设成inherit之后，子进程的所有输入输出直接和当前运行的Node控制台绑定，不管是正常执行日志还是报错信息，你都能实时在终端看到，不存在“错误藏起来看不到”的问题。
• 为什么不做嵌套回调：如果第一个脚本是启动常驻服务的，它永远不会主动退出，嵌套回调的方式会永远等不到触发时机，和你“固定留30秒初始化时间”的需求完全不匹配。

常见补坑提醒 #

• 不要用普通的shell.exec()方法：这个方法会启动一个shell来执行命令，相比execFile多了一层shell进程，一旦shell层面的输出卡住，排查难度更高。
• 如果需要更灵活的进程控制，比如要主动杀掉第一个脚本的进程，可以把runScript返回的子进程对象存下来，需要退出的时候调用child.kill()即可，不需要写复杂的嵌套逻辑。

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