Node.js+Mocha+SuperTest集成测试：用户创建异步时序异常

首先，你的测试失败根源是异步流程没有被正确等待——Mocha在createUser完成数据库存储之前就执行了后续的请求断言，导致测试时目标用户还不存在，自然会失败。我们一步步来解决这个问题，再聊聊测试前置准备的更优方案。

一、修复当前测试的异步问题 #

看你的测试代码，虽然用了done回调，但嵌套的then链没有正确关联到Mocha的异步生命周期，导致Mocha没有等待所有异步操作完成就结束了测试。这里有两种更可靠的写法：

写法1：用Async/Await（推荐，更简洁易读） #

Mocha原生支持async函数，会自动等待函数内的Promise完成：

it("respond with 403 forbidden, because a standard user cant delete other users", async function () { 
  // 先等待用户创建完成
  await createUser();
  // 再等待登录拿到token
  const responseBody = await login(userLoginData);
  // 最后执行请求并断言
  await request(app) 
    .delete("/users/0000000000006204aefc242c") 
    .set("Authorization", `Bearer ${responseBody.body.accessToken}`) 
    .expect(403, { 
      Error: "Forbidden", 
      message: "Forbidden for your rank, if its not your own account." 
    }); 
});

写法2：正确使用Done回调 #

如果坚持用then链，要确保所有异步操作完成后调用done，并且捕获错误传给Mocha：

it("respond with 403 forbidden, because a standard user cant delete other users", function (done) { 
  createUser()
    .then(() => login(userLoginData))
    .then((responseBody) => {
      return request(app) 
        .delete("/users/0000000000006204aefc242c") 
        .set("Authorization", `Bearer ${responseBody.body.accessToken}`) 
        .expect(403, { 
          Error: "Forbidden", 
          message: "Forbidden for your rank, if its not your own account." 
        });
    })
    .then(() => done()) // 所有操作完成，通知Mocha测试结束
    .catch(err => done(err)); // 捕获任何错误，避免Mocha超时
});

之前的代码里，你把login().then(...)直接作为createUser().then()的参数，这种嵌套写法会导致Promise链断裂，Mocha无法感知到后续的异步操作，自然会提前结束测试。

二、测试前置准备的更优方案 #

单独在每个测试用例里写createUser不是长久之计，推荐用以下方式优化：

1. 用Mocha钩子统一管理测试数据 #

用before/beforeEach在测试前批量准备数据，after/afterEach在测试后清理，避免测试间的污染：

let testUserToken;

// 所有测试开始前只创建一次测试用户（如果测试间数据不互相影响）
before(async function() {
  await createUser();
  const loginRes = await login(userLoginData);
  testUserToken = loginRes.body.accessToken;
});

// 或者每个测试前都创建新用户（确保测试独立性）
// beforeEach(async function() {
//   await createUser();
//   const loginRes = await login(userLoginData);
//   testUserToken = loginRes.body.accessToken;
// });

// 测试后清理数据，避免影响下一次测试
afterEach(async function() {
  await User.deleteOne({ username: "User" }); // 根据你的User模型调整删除逻辑
});

// 测试用例里直接用提前准备好的token
it("respond with 403 forbidden...", async function () { 
  await request(app) 
    .delete("/users/0000000000006204aefc242c") 
    .set("Authorization", `Bearer ${testUserToken}`) 
    .expect(403, { 
      Error: "Forbidden", 
      message: "Forbidden for your rank, if its not your own account." 
    }); 
});

2. 封装测试工具函数 #

把创建用户、登录这些重复操作封装成工具函数，让测试代码更简洁：

// 封装生成测试用户token的函数
async function getTestUserToken(customParams = {}) {
  const defaultParams = { 
    username: "TestUser", 
    password: "123456789", 
    firstName: "Max", 
    lastName: "Mustermann", 
    role: JSON.stringify(Role.User) 
  };
  const userParam = { ...defaultParams, ...customParams };
  
  const user = new User(userParam);
  user.hash = bcrypt.hashSync(userParam.password, 10);
  await user.save();

  // 直接用SuperTest调用登录接口，不用依赖外部login函数
  const loginRes = await request(app)
    .post("/auth/login") // 替换成你的实际登录接口路径
    .send({ username: userParam.username, password: userParam.password });
  
  return { token: loginRes.body.accessToken, user };
}

// 测试用例里直接调用
it("respond with 403 forbidden...", async function () { 
  const { token } = await getTestUserToken();
  await request(app) 
    .delete("/users/0000000000006204aefc242c") 
    .set("Authorization", `Bearer ${token}`) 
    .expect(403, { 
      Error: "Forbidden", 
      message: "Forbidden for your rank, if its not your own account." 
    }); 
});

3. 避免硬编码测试数据 #

你测试里的用户ID是硬编码的，推荐动态创建测试目标用户，让测试更可靠：

it("respond with 403 forbidden when deleting another user", async function () { 
  // 创建当前测试用户
  const { token, user: currentUser } = await getTestUserToken();
  // 创建另一个目标用户
  const { user: targetUser } = await getTestUserToken({ username: "TargetUser123" });

  await request(app) 
    .delete(`/users/${targetUser._id}`) // 用动态生成的目标用户ID
    .set("Authorization", `Bearer ${token}`) 
    .expect(403, { 
      Error: "Forbidden", 
      message: "Forbidden for your rank, if its not your own account." 
    }); 
});

4. 用数据库事务提升测试效率（可选） #

如果你的数据库支持事务（比如MongoDB 4.0+、PostgreSQL），可以在beforeEach里开启事务，afterEach里回滚，这样测试数据不会真的写入数据库，既快又不会污染数据库：

let session;

beforeEach(async function() {
  session = await mongoose.startSession(); // 假设用Mongoose
  session.startTransaction();
  // 创建用户时绑定session
  await createUser({ session });
});

afterEach(async function() {
  await session.abortTransaction();
  session.endSession();
});

总结 #

当前问题的核心是异步流程未正确等待，用async/await或正确处理done回调就能解决。长期来看，用Mocha钩子管理测试生命周期、封装工具函数、清理测试数据，能让你的集成测试更稳定、更易维护。

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