求助：Jest测试失败后globalTeardown未执行的问题

我看到你遇到了一个Jest测试里的常见痛点：测试全过的时候，globalTeardown能正常关停Serverless离线服务，但只要有测试失败，清理脚本就直接"罢工"，服务一直挂在后台。结合你的代码和报错信息，我整理了问题原因和可行的解决方案：

问题细节回顾 #

你的teardown.js代码如下：

module.exports = async function() { 
  let slsOfflineProcess = global.__SERVERD__; 
  slsOfflineProcess.stdin.write('q\n'); 
  slsOfflineProcess.stdin.pause(); 
  await slsOfflineProcess.kill('SIGINT'); 
  console.log('Serverless Offline stopped'); 
};

测试失败时，Jest直接终止进程，完全跳过了清理步骤，报错输出示例：

7 | expect(res.statusCode).toEqual(200);
> 8 | expect(res.body).toEqual('Go Serverless v1.0! Your function executed successfully!');
 | ^
9 | });
10 | });
11 | at Object.<anonymous> (handler.test.js:8:20)
Test Suites: 1 failed, 1 total
Tests: 1 failed, 1 total
Snapshots: 0 total
Time: 1.972s, estimated 2s
Ran all test suites.
npm ERR! Test failed. See above for more details.

为什么会出现这个问题？ #

Jest的globalTeardown默认只在所有测试成功执行完毕后才会触发。一旦有测试失败，Jest会触发错误处理流程，直接终止Node进程，根本没机会等待异步的清理逻辑执行完成。另外你原代码里的await slsOfflineProcess.kill('SIGINT')其实无效——kill()方法本身不返回Promise，等于没真正等待进程退出。

两种可行的解决办法 #

办法一：添加全局错误兜底，强制触发清理 #

我们可以在测试启动时注册全局异常捕获器，同时监听Jest的测试失败事件，不管测试成功还是失败，都确保清理逻辑能运行。

1. 新建一个setup.js文件：

module.exports = () => {
  // 捕获未处理的同步异常
  process.on('uncaughtException', async () => {
    await cleanUpServer();
    process.exit(1);
  });

  // 捕获未处理的Promise拒绝
  process.on('unhandledRejection', async () => {
    await cleanUpServer();
    process.exit(1);
  });

  // 监听Jest的测试失败事件
  if (global.jest) {
    jest.getRunner().on('testFailure', async () => {
      await cleanUpServer();
    });
  }
};

async function cleanUpServer() {
  const serverProcess = global.__SERVERD__;
  if (serverProcess && !serverProcess.killed) {
    serverProcess.stdin.write('q\n');
    serverProcess.stdin.pause();
    // 真正等待进程退出后再结束
    await new Promise(resolve => serverProcess.on('exit', resolve));
    serverProcess.kill('SIGINT');
    console.log('Serverless Offline stopped (from error handler)');
  }
}

2. 在jest.config.js中配置这个文件：

module.exports = {
  // 你的其他Jest配置
  setupFilesAfterEnv: ['./setup.js'],
  globalTeardown: './teardown.js'
};

办法二：修复原teardown脚本的异步逻辑 #

把原来的teardown.js改成真正等待进程退出的版本，同时给Jest设置足够的超时时间，确保清理操作能完成：

修改后的teardown.js：

module.exports = async function() { 
  const serverProcess = global.__SERVERD__; 
  if (serverProcess && !serverProcess.killed) {
    serverProcess.stdin.write('q\n'); 
    serverProcess.stdin.pause(); 
    // 等待进程退出事件，确保清理完成
    await new Promise(resolve => serverProcess.on('exit', resolve));
    serverProcess.kill('SIGINT');
    console.log('Serverless Offline stopped'); 
  }
};

然后在jest.config.js里延长测试超时：

module.exports = {
  // 你的其他Jest配置
  testTimeout: 5000, // 根据你的服务启停速度调整
  globalTeardown: './teardown.js'
};

额外小提示 #

• 一定要确保global.__SERVERD__在测试启动脚本里被正确赋值，指向Serverless离线进程的实例，不然清理脚本找不到进程就白忙活了。
• 可以在清理函数里多加点日志，方便排查到底有没有执行到清理逻辑。
• 如果用的是Jest 27+版本，尽量不要开启forceExit: true，这个配置会强制终止进程，跳过所有异步清理步骤。

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