如何调试Node.js子进程运行20分钟后出现的EBADF错误？

问题 #

我有一个Node.js开发环境进程管理器，运行约20分钟后，每次尝试生成新进程时都会持续抛出spawn EBADF错误（截断堆栈信息如下）：

Error: spawn EBADF
    at ChildProcess.spawn (node:internal/child_process:420:11)
    at spawn (node:child_process:757:9)
    at [...] {
  errno: -9,
  code: 'EBADF',
  syscall: 'spawn'
}

当错误抛出时，我已记录了要生成的可执行文件的stats对象：

Stats {
  dev: 16777233,
  mode: 33261,
  nlink: 1,
  uid: 501,
  gid: 20,
  rdev: 0,
  blksize: 4096,
  ino: 25264887,
  size: 5336594,
  blocks: 10424,
  atimeMs: 1697802509011.12,
  mtimeMs: 1668201906279.7305,
  ctimeMs: 1668201906279.7305,
  birthtimeMs: 1668201906249.335,
  atime: 2023-10-20T11:48:29.011Z,
  mtime: 2022-11-11T21:25:06.280Z,
  ctime: 2022-11-11T21:25:06.280Z,
  birthtime: 2022-11-11T21:25:06.249Z
}

mode表明该文件是可执行的。我推测错误出在环境中，但不知道如何继续调试。请问调试Node.js内部的下一步是什么？如何查看具体的spawn调用以检测错误来源？还有哪些参与Node.js spawn的文件需要检查以确保正常？

调试步骤与排查方向 #

1. 追踪完整Spawn调用参数 #

• 在调用spawn的代码位置，打印完整参数：包括可执行文件路径、args数组、options对象，重点核查：
  • 可执行文件是否用绝对路径？相对路径可能因进程工作目录变化失效
  • options.cwd（工作目录）是否存在且有访问权限
  • options.stdio配置是否合法，是否错误复用了已关闭的文件描述符
• 用util.inspect打印完整options对象，避免遗漏细节：

  const util = require('util');
  console.log('Spawn 调用参数:', util.inspect([execPath, args, options], { depth: null }));
  

2. 排查文件描述符泄漏 #

EBADF本质是“无效文件描述符”，长时间运行后出现大概率是泄漏问题：

• 用lsof -p <主进程PID>查看主进程打开的文件描述符数量，对比启动初期和运行20分钟后的数值，确认是否持续增长
• 检查代码中是否有打开文件、创建socket后未正确关闭的场景，尤其是异步操作中遗漏close/destroy调用的情况
• 用process.getActiveResourcesInfo()查看进程活跃资源，排查未释放的子进程、文件句柄等

3. 调试Node.js内部Spawn逻辑 #

• 启动时添加--trace-child-process参数，启用Node.js内部调试日志，会打印Spawn的完整流程和系统调用细节
• 使用node inspect或Chrome DevTools附加到进程，在node:internal/child_process模块的spawn方法处打断点，逐步跟踪参数传递和底层调用
• 查看Node.js源码中Spawn的实现：lib/internal/child_process.js（JS层）和src/child_process.cc（C++底层），重点关注文件描述符传递、环境变量处理部分

4. 检查环境与系统资源 #

• 对比运行前后的process.env，确认环境变量是否异常（比如PATH被篡改导致可执行文件查找失败）
• 用ulimit -n查看进程的最大文件描述符限制，若接近上限会导致无法创建新句柄（包括子进程的标准IO）
• 验证可执行文件所在挂载点状态，排查是否出现磁盘只读、挂载失效等底层访问问题

5. 简化场景复现验证 #

• 编写最小化测试脚本，循环调用spawn执行目标可执行文件，模拟长时间运行场景，看是否复现错误
• 逐步添加进程管理器的逻辑到测试脚本中，定位触发错误的具体代码路径

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