如何在 node.js 上调试“错误：生成 ENOENT”？

Question

当我收到以下错误时：

 events.js:72
        throw er; // Unhandled 'error' event
              ^
Error: spawn ENOENT
    at errnoException (child_process.js:1000:11)
    at Process.ChildProcess._handle.onexit (child_process.js:791:34)

我可以按照什么程序来修复它？

作者注：这个错误的很多问题鼓励我发布这个问题以供将来参考。

相关问题：

• 使用带有 NODE_ENV=production 的 spawn 函数
• node.js child_process.spawn ENOENT 错误-仅在 supervisord 下
• 产生 ENOENT node.js 错误
• https://stackoverflow.com/questions/27603713/nodejs-spawn-enoent-error-on-travis-calling-global-npm-package
• Node JS - Grunt 任务中的 child_process spawn(‘npm install’) 导致 ENOENT 错误
• 运行“工头”任务致命错误：spawn ENOENT
• 节点 js 中未处理的错误事件错误：在 errnoException (child_process.js:975:11) 处生成 ENOENT
• Node.js SpookyJS：执行 hello.js 时出错
• https://stackoverflow.com/questions/26572214/run-grunt-on-a-directory-nodewebkit
• 使用子进程 NodeJS 运行 exe 文件
• 节点：child_process.spawn 无法在 Java 上运行，即使它在路径中（ENOENT）
• 使用 NodeJS 产生 ENOENT 错误（与 PYTHON 相关）
• 图像大小调整在 node.js (partial.js) 中不起作用（未安装的依赖项）
• npm install error ENOENT （构建依赖问题）
• 无法在 Windows 7 上安装 node.js - oracle 模块（构建依赖问题）
• 在 Windows 上使用 nodejs 安装 gulp 时出错（奇怪的情况）

原文由 laconbass 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 1

如何研究引发错误的 spawn 调用：

• 使用 NODE_DEBUG=child_process ，感谢@karl-richter。 简单，快速，2019 年 10 月
• 使用包装器装饰 child_process.spawn ，感谢@jiaji-zhou。 简单，快速，2015 年 1 月
• 漫长的过程，归功于@laconbass。 复杂，时间成本，2014 年 12 月

已知的常见原因

1. 环境问题

   • 系统中不存在命令可执行文件（未安装依赖项）。 看 prominc的回答
   • 该命令可执行文件不存在于由 PATH 环境变量指定的目录中。
   • 可执行二进制文件是使用不兼容的库编译的。 见 达尼洛-拉米雷斯的回答

2. 仅限 Windows 的错误/怪癖

   • ’.cmd’ 扩展名/外壳：是的。 见 李正回答
   • 管理员权限。 见 史蒂夫的回答

3. 错误 spawn('command', ['--argument', 'list'], { cwd, env, ...opts }) 用法

   • 指定的工作目录（ opts.cwd ）不存在· 见 leeroy-brun 的回答
   • 命令中的参数列表 Stringspawn('command --wrong --argument list')
   • 命令字符串中的环境变量spawn('ENV_VAR=WRONG command')
   • 参数列表 Array 指定为 Stringspawn('cmd', '--argument list')
   • PATH 变量spawn('cmd', [], { env: { variable } } => spawn('cmd', [], { env: { ...process.env, variable } }

---

ENOENT 有两个可能的来源：

1. 您正在编写的代码
2. 你依赖的代码

当源代码是您依赖的代码时，通常的原因是 环境问题（或 Windows 怪癖）

---

原文由 laconbass 发布，翻译遵循 CC BY-SA 4.0 许可协议

Answer 2

注意：此错误几乎总是由命令不存在、工作目录不存在或仅限于 Windows 的错误引起。

我找到了一种特别简单的方法来了解以下问题的根本原因：

 Error: spawn ENOENT

这个错误的问题是，错误消息中很少有信息告诉你调用点在哪里，即找不到哪个可执行文件/命令，特别是当你有一个很大的代码库，其中有很多 spawn 调用.另一方面，如果我们知道导致错误的确切命令，那么我们可以按照 @laconbass 的回答 来解决问题。

我找到了一种非常简单的方法来发现导致问题的命令，而不是像@laconbass 的回答中建议的那样在代码中的任何地方添加事件监听器。关键思想是用包装器包装原始的 spawn 调用，该包装器打印发送到 spawn 调用的参数。

这是包装函数，将其放在 index.js 或任何服务器启动脚本的顶部。

 (function() {
    var childProcess = require("child_process");
    var oldSpawn = childProcess.spawn;
    function mySpawn() {
        console.log('spawn called');
        console.log(arguments);
        var result = oldSpawn.apply(this, arguments);
        return result;
    }
    childProcess.spawn = mySpawn;
})();

然后下次运行应用程序时，在未捕获的异常消息之前，您将看到类似这样的内容：

 spawn called
{ '0': 'hg',
  '1': [],
  '2':
   { cwd: '/* omitted */',
     env: { IP: '0.0.0.0' },
     args: [] } }

这样你就可以很容易地知道实际执行的命令是什么，然后你可以找出为什么nodejs找不到可执行文件来解决问题。

原文由 Jiaji Zhou 发布，翻译遵循 CC BY-SA 4.0 许可协议