Jest+TS配置：如何指定测试执行顺序并复用服务启动逻辑？

问题分析 #

你遇到的核心问题是Jest默认不保证测试文件的执行顺序，导致依赖服务器的测试文件先于服务器启动代码执行，从而失败。下面给出几种可行的解决方案，以及对应的最佳实践建议。

解决方案一：使用Jest全局前置文件（推荐） #

这是最简洁的标准方案，无需手动控制测试顺序，让Jest自动在所有测试执行前完成服务器启动：

1. 修改前置文件命名：将tests/SetupTests.spec.ts重命名为tests/SetupTests.ts（去掉.spec后缀，因为它不是测试用例文件，而是全局初始化脚本）
2. 配置Jest加载全局前置文件：在你的Jest配置文件（通常是jest.config.js或jest.config.ts）中添加以下配置：

module.exports = {
  // 其他配置...
  setupFilesAfterEnv: ['./tests/SetupTests.ts'],
};

3. 保留原初始化代码：SetupTests.ts中的beforeAll和afterAll逻辑保持不变，Jest会在所有测试文件执行前自动运行beforeAll启动服务器，所有测试完成后运行afterAll关闭服务器。

注意：不需要在这个文件中手动引入其他.spec.ts文件，Jest会自动发现并执行所有符合命名规则的测试文件，且都会继承这个全局初始化逻辑。

解决方案二：自定义测试执行顺序（不推荐） #

如果你确实需要强制指定测试文件的执行顺序，可以通过自定义测试排序器实现，但这种方式不够灵活，且不符合Jest的设计初衷：

1. 创建一个测试排序器文件（比如tests/testSequencer.js）：

const Sequencer = require('@jest/test-sequencer').default;

class CustomSequencer extends Sequencer {
  sort(tests) {
    // 让SetupTests.spec.ts第一个执行
    const setupTest = tests.find(t => t.path.includes('SetupTests.spec.ts'));
    const otherTests = tests.filter(t => t.path !== setupTest?.path);
    return setupTest ? [setupTest, ...otherTests] : tests;
  }
}

module.exports = CustomSequencer;

2. 在Jest配置中指定这个排序器：

module.exports = {
  // 其他配置...
  testSequencer: './tests/testSequencer.js',
};

最佳实践说明 #

• 不建议在每个测试文件中重复添加beforeAll/afterAll：这会导致服务器被重复启动/关闭，浪费资源，还可能引发端口占用冲突，同时增加代码冗余。
• 全局前置文件是标准方案：它能统一管理测试环境的初始化和清理逻辑，符合DRY（Don't Repeat Yourself）原则，是API测试中启动/关闭服务器的常规做法。
• 测试隔离性补充：如果你的测试会修改服务器状态（比如操作数据库导致数据残留），可以在每个测试用例前添加beforeEach做数据重置，而非重启服务器，这样既保证隔离性又兼顾效率。

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