使用Jest测试Hapi路由时，测试失败会导致进程挂起

我之前也碰到过一模一样的情况！这种问题通常是因为测试失败时，Hapi服务器的一些内部资源或者事件监听器没有被正确清理，导致Node.js进程找不到退出的时机——哪怕afterEach和afterAll看起来都执行了，进程还是会卡着。

下面是几个能解决这个问题的方案，按优先级推荐：

1. 确保在afterEach中可靠地停止服务器 #

你提到添加启动和停止操作没用，大概率是停止服务器的逻辑没处理好错误，或者时序有问题。试试用try/finally来保证不管测试成功还是失败，服务器都会被停止，同时给停止操作加超时兜底：

// @flow
import createServer from '../server';

describe('Hapi Healthchecks', () => {
  let server;

  beforeEach(async () => {
    server = await createServer();
    // 部分场景下inject不需要启动服务器，但显式启动能避免隐式状态问题
    await server.start();
  });

  // 关键：用try/finally确保服务器一定会被停止
  afterEach(async () => {
    try {
      if (server) {
        // 加超时参数，强制在指定时间内终止服务器
        await server.stop({ timeout: 5000 });
      }
    } catch (err) {
      console.error('停止服务器时出错:', err);
    } finally {
      server = null; // 清空引用，避免内存泄漏
    }
  });

  test('Hapi Healthchecks respond correctly', async () => {
    const response = await server.inject({
      method: 'GET',
      url: '/health',
    });
    expect.assertions(1);
    expect(response.statusCode).toBe(200);
  });
});

2. 检查是否有其他未清理的外部资源 #

如果上面的方法没用，那可能是你的createServer里初始化了其他资源（比如数据库连接池、WebSocket服务、定时器），这些资源在测试失败时没有被关闭：

• 可以在createServer里给服务器绑定onPreStop钩子，在服务器停止时自动清理这些外部资源
• 或者在afterEach里，除了停止服务器，手动调用资源的销毁方法

3. 用Jest的兜底配置强制退出 #

如果前面的方法都试了还是不行，可以在Jest配置里加两个参数作为临时解决方案：

• --forceExit：不管有没有未处理的资源，强制终止进程
• --detectOpenHandles：让Jest检测并打印出未关闭的资源，帮你定位问题

你可以在package.json的测试脚本里加上：

"scripts": {
  "test": "jest --forceExit --detectOpenHandles"
}

为什么测试通过时没问题？ #

测试通过时，代码执行流程完整，Hapi的inject方法会自动处理临时请求上下文，可能隐式清理了一些资源；但测试失败时，断言抛出的错误会打断正常流程，导致部分异步清理逻辑没被执行，或者服务器内部状态处于未完成状态，从而卡住进程。

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