单元测试中填充MongoDB数据导致测试间相互干扰的问题

嘿，这个问题我太熟了——异步单元测试并行跑的时候，共享的固定Seed数据简直是噩梦，多个测试同时读写同一份数据，肯定会互相干扰。我给你几个落地的解决方案，从简单到进阶都有：

1. 给每个测试生成独立的随机数据 #

别再用硬编码的固定ObjectID了！把你的Seed逻辑改成函数形式，每次调用都生成全新的ID和数据，让每个测试拿到的都是专属数据集：

修改你的collectionSeed.js：

const { ObjectID } = require('mongodb');
import { CollectionModel } from "../../models/collection";

// 改成动态生成数据的函数，每次调用都返回新实例
export const generateCollections = () => {
  const collectionOneId = new ObjectID();
  const collectionTwoId = new ObjectID();
  return [{ _id: collectionOneId }, { _id: collectionTwoId }];
};

// 新增填充数据的函数，支持传入自定义数据（可选）
export const seedCollections = async (customCollections = null) => {
  const collections = customCollections || generateCollections();
  await CollectionModel.insertMany(collections);
  return collections;
};

然后在每个测试用例里，调用seedCollections()获取当前测试的专属数据——这样再也不会出现两个测试抢同一条数据的情况了。

2. 测试前后强制清理数据库 #

不管用什么Seed数据，确保每个测试运行在干净的数据库环境里。用测试框架的钩子函数（比如Jest的beforeEach/afterEach），在每个测试前后清空对应集合：

import { CollectionModel } from "../models/collection";
import { seedCollections } from "../utils/collectionSeed";

describe('Collection 相关测试', () => {
  beforeEach(async () => {
    // 测试前清空集合，确保没有残留数据
    await CollectionModel.deleteMany({});
    // 填充当前测试的专属数据，挂载到测试上下文方便用例访问
    const testCollections = await seedCollections();
    test.currentCollections = testCollections;
  });

  afterEach(async () => {
    // 测试结束后再次清空，彻底隔离测试环境
    await CollectionModel.deleteMany({});
  });

  test('应该能成功查询到指定集合', async () => {
    const targetCollection = test.currentCollections[0];
    const result = await CollectionModel.findById(targetCollection._id);
    expect(result).not.toBeNull();
  });
});

3. 给并行测试加数据库隔离标识 #

如果你的测试套件需要保持并行执行以提升速度，可以给每个测试的数据库集合加随机后缀或测试名称标识，创建临时集合来隔离数据：

// 在collectionSeed.js里扩展支持临时集合
export const seedCollections = async (collectionPrefix = 'test') => {
  // 生成随机后缀，保证集合名唯一
  const randomSuffix = Math.random().toString(36).substring(2, 10);
  const tempCollectionName = `${collectionPrefix}_${randomSuffix}`;
  // 创建临时集合模型
  const TempCollectionModel = CollectionModel.db.model(tempCollectionName, CollectionModel.schema);
  
  const collections = generateCollections();
  await TempCollectionModel.insertMany(collections);
  
  // 返回临时模型和数据，测试后记得删除集合
  return { model: TempCollectionModel, collections };
};

// 测试用例中使用
test('应该能成功创建新集合', async () => {
  const { model: TestCollection, collections } = await seedCollections();
  const result = await TestCollection.create({ name: '临时测试集合' });
  expect(result._id).toBeDefined();
  // 测试结束后删除临时集合
  await TestCollection.collection.drop();
});

4. 临时方案：禁用测试并行执行 #

如果以上方案暂时来不及实现，最简单的应急办法就是让测试串行执行，避免同时操作数据库。比如在Jest里加上--runInBand参数：

jest --runInBand

不过这个会减慢测试速度，适合小型测试套件或者作为过渡方案。

核心思路总结 #

本质上就是要让每个测试拥有完全独立的数据库环境——要么数据独立（每个测试用自己的随机数据），要么环境独立（每个测试用自己的临时集合），彻底消灭共享状态带来的干扰。

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