如何排查node-tap测试无法正常退出的原因？

一、先揪出未释放的异步资源 #

测试超时90%都是因为有没关的异步资源（数据库连接、Fastify服务器、定时器、WebSocket这些），可以这么查：

• 加--trace-warnings参数跑测试，Node会直接输出资源泄漏的警告，比如未关闭的句柄：

  tap --node-arg=--trace-warnings test/your-test-file.js
  

• 在测试代码里加个退出钩子，打印当前活跃的资源，一眼就能看到啥没关：

  process.on('exit', () => {
    console.log('还在活跃的句柄:', process._getActiveHandles());
    console.log('未完成的请求:', process._getActiveRequests());
  });
  

  虽然process._getActiveHandles()是Node内部API，但调试的时候贼好用，别在生产代码里用就行。
• 要是用Fastify，测试完一定要调用fastify.close()，它会自动关掉服务器和插件带的资源（比如你用的数据库连接如果是Fastify插件管理的，关Fastify就一起关了）。

二、让TAP的日志更有用 #

TAP本身不会直接告诉你“为啥测试卡着不结束”，但可以调参数让日志更能帮到你：

• 加--bail，测试一超时就立刻停，不用等所有测试跑完浪费时间：

  tap --bail test/your-test-file.js
  

• 用--jobs=1单线程跑测试，避免多线程日志乱跳，更容易定位到出问题的测试用例：

  tap --jobs=1 test/your-test-file.js
  

• 加--trace-exit跟踪进程退出流程，能看到有没有代码在阻止进程退出：

  tap --node-arg=--trace-exit test/your-test-file.js
  

三、分步缩小排查范围 #

• 先单独跑单个测试文件，甚至单个测试用例，找到到底是哪个测试导致的超时；
• 给可疑的测试用例设更短的超时，比如：

  tap.test('出问题的测试', { timeout: 3000 }, (t) => {
    // 测试代码
    t.end();
  });
  

  快速触发超时，方便盯着日志找问题。

关于TAP的日志提示 #

TAP默认不会主动告诉你测试未结束的原因，它只能检测到进程没退出，但没法自动分析资源泄漏。你用的--debug参数是开启V8的调试模式，不是针对资源泄漏的日志，所以没啥用。前面说的--trace-warnings和--trace-exit才是专门对付这类问题的。

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