如何通过TypeScript配置Mocha全局Fixture实现测试后自动关闭Express服务器？

核心原因分析 #

不是必须要用mjs/cjs扩展名，问题出在Mocha没有正确编译并加载你的TS格式全局钩子文件，同时可能存在钩子配置或脚本参数的问题。

具体解决步骤 #

1. 确保Mocha能处理TypeScript文件 #

Mocha本身不支持直接编译TS，必须配合ts-node或tsx来转译。在测试脚本中要明确引入TS处理器：

// package.json
"scripts": {
  "test": "mocha -r ts-node/register --file fixtures.ts test/**/*.ts"
}

这里的--file参数是关键，它会让Mocha在加载所有测试文件之前优先执行指定的全局钩子文件，比直接把fixtures.ts放在测试文件列表里更可靠。

2. 修正全局钩子文件的写法 #

确保fixtures.ts导出符合Mocha要求的钩子，同时处理Express服务器关闭的异步逻辑：

// fixtures.ts
import server from '../src/server';

export const mochaHooks = {
  async afterAll() {
    // 用Promise包裹确保服务器完全关闭后再结束测试
    await new Promise<void>((resolve) => {
      server.close(() => {
        resolve();
      });
    });
  }
};

如果你的项目用ES模块（package.json里有"type": "module"），需要调整tsconfig.json的配置，并修改Mocha脚本：

// tsconfig.json
{
  "module": "ESNext",
  "moduleResolution": "NodeNext"
}

// package.json的test脚本
"test": "mocha --loader ts-node/esm --file fixtures.ts test/**/*.ts"

3. 验证钩子执行顺序 #

如果之前只是把fixtures.ts放在测试文件列表的开头，可能因为Mocha并行加载测试文件导致钩子没有被全局执行，--file参数会强制Mocha先执行该文件的钩子逻辑，确保全局生效。

4. 检查服务器实例是否正确导出 #

确保你的Express服务器实例是正确导出的，比如：

// src/server.ts
import express from 'express';
const app = express();
// ... 中间件和路由配置 ...
const server = app.listen(3000);
export default server;

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