如何避免Jest并行测试与mongodb-memory-server的冲突

问题背景 #

我在Node/Mongoose/Express项目中使用mongodb-memory-server进行测试，原本每个测试文件都单独启动实例导致测试速度缓慢，于是改用globalSetup和globalTeardown共享数据库实例，并在setupFilesAfterEnv中添加了以下清理代码：

afterEach(async () => {
  const collections = mongoose.connection.collections;

  for (const key in collections) {
    const collection = collections[key];
    await collection.deleteMany({});
  }
});

测试速度大幅提升，但并行运行测试时偶发失败，报错“邮箱地址已被使用”——原因是register.test.ts和login.test.ts的测试用例会创建相同邮箱的用户。添加--runInBand参数串行执行测试时，该问题消失。针对这类问题，以下是具体的处理建议：

1. 是否应在beforeAll中创建跨测试共用的通用测试数据？ #

不建议这么做。跨测试共用数据会大幅提升测试用例的耦合度，一个测试的修改可能直接影响其他测试的结果，违背了测试用例独立性的核心原则。而且即使串行时没问题，并行场景下依然会出现数据竞争冲突，无法从根源解决问题。

2. 是否应创建工厂类来避免此类冲突？ #

这是最推荐的解决方案。可以编写一个测试数据工厂（比如UserFactory），每次创建用户时自动生成唯一标识的邮箱——比如用随机字符串拼接：test-${Math.random().toString(36).slice(2)}@example.com，或者结合测试框架的动态变量（如Jest的testName）生成唯一值。这样每个测试用例生成的用户数据完全独立，从根源上避免邮箱重复的冲突。

3. 像login、register这类核心功能是否不应并行测试？ #

没必要刻意禁止并行。核心功能恰恰需要验证并发场景下的正确性，只要解决了测试数据的隔离问题，并行测试反而能更快验证功能的稳定性。而且并行执行能显著提升测试效率，尤其是当测试用例数量增多时，串行会大幅拖慢整体测试周期。

4. 即使速度较慢，是否应为每个测试文件新建mongodb-memory-server？ #

除非你的测试场景有特殊需求（比如每个测试文件需要完全独立的数据库环境，无法共享实例），否则不建议这么做。新建mongodb-memory-server实例的开销极大，会让测试时间成倍增加。当前的问题并非共享实例本身，而是测试数据的隔离机制不完善，解决数据隔离比重新创建实例更高效。

5. 更多建议 #

• 使用事务隔离测试数据：如果你的MongoDB版本支持（4.0+），可以在每个测试用例开始时开启事务，测试结束后回滚，无需手动删除数据，隔离性更好，并行时不会互相干扰。
• 给所有可能冲突的字段加唯一标识：除了邮箱，用户名等其他可能重复的字段也用唯一值生成，确保每个测试的数据集完全独立。
• 优化清理逻辑：当前的afterEach是全局删除所有数据，并行时可能出现“一个测试在清理，另一个测试正在写入”的竞态问题。可以改为在每个测试开始前，针对当前测试要用到的集合做精准清理，避免全局操作的冲突。
• 合理控制并行数：如果担心并行冲突，可以用jest --maxWorkers参数限制并行的工作进程数，同时配合数据工厂生成唯一数据，在效率和稳定性之间取得平衡。

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