Node.js调用exec执行命令报AssignProcessToJobObject:(87)参数错误

Node.js环境中调用child_process.exec方法执行ls -la命令时，程序持续抛出错误：AssignProcessToJobObject: (87) The parameter is incorrect.，已排查调用链路上下游逻辑未定位问题根因。

复现代码如下：

exec("ls -la", (error, stdout, stderr) => {
  if (error) reject({ error });
  if (stderr) reject({ stderr });
  resolve(stdout);
});

注：上述代码本身存在逻辑缺陷：触发error/stderr分支执行reject后未中断流程，会继续向下执行resolve，导致Promise状态混乱，修复时需要在reject后补充return语句。

该报错是Windows平台下的特有兼容问题，触发原因是Node.js的底层依赖libuv在创建子进程时，调用Windows系统API AssignProcessToJobObject的传参逻辑，和父进程所处的进程托管环境存在冲突，常见触发场景：

• 使用VS Code、IDEA等IDE的内置终端运行Node脚本，IDE会对启动的进程做作业对象托管，限制子进程权限
• 使用部分Windows服务管理工具、终端增强工具启动Node进程，自动给进程加了作业对象隔离标记
• Node 16.x、18.x早期版本在Windows平台存在已知的libuv层兼容bug

额外提示：纯Windows原生环境（无WSL、无Git Bash等类Unix兼容层）下本身不存在ls -la命令，就算修复了进程报错，命令本身也会执行失败，原生Windows环境需要替换为对应系统命令（cmd下用dir，PowerShell下用Get-ChildItem）。

按优先级排序，逐一验证即可：

• 升级Node.js版本到18.17.0+、20.x及以上的长期支持补丁版本，官方已经在新版本libuv中修复了该API传参兼容问题，是最彻底的修复方式
• 临时无法升级Node版本时，调用exec时显式增加shell: true配置，绕过默认的进程创建逻辑，参考代码：

const { exec } = require('child_process');
exec("ls -la", { shell: true }, (error, stdout, stderr) => {
  if (error) {
    reject({ error });
    return;
  }
  if (stderr) {
    reject({ stderr });
    return;
  }
  resolve(stdout);
});

• 避开IDE内置终端、进程托管工具的环境，打开系统原生终端进入项目目录，手动执行Node启动命令运行脚本
• 不需要子进程弹出独立窗口的场景，可增加windowsHide: true配置，也可规避该API调用错误，配置写法：

exec("ls -la", { windowsHide: true }, (error, stdout, stderr) => {
  // 回调逻辑同上，注意分支reject后加return
})

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