Jest中beforeAll/afterAll异步端点测试问题求助

核心问题分析 #

你之前的错误在于在beforeAll/afterAll钩子内部嵌套定义test()函数，Jest的钩子是用来执行测试前后的准备/清理逻辑，不是用来包裹测试用例的。test()必须直接定义在测试文件的顶层作用域，钩子内部只放逻辑代码，不能嵌套test。

正确的钩子用法 #

把用户创建和数据库清理的逻辑直接放在beforeAll和afterAll里，同时要处理异步逻辑（用async/await），还要保证即使测试失败，清理步骤也能执行。另外给用户名加时间戳后缀，避免多测试文件运行时的用户名冲突，不用手动改用户名。

修正后的代码：

const axios = require("axios");
const API_URL = process.env.API_TEST_URL;
let TOKEN;
// 生成唯一用户名，避免多文件测试冲突
const USER_PSEUDO = `TEST_${Date.now()}`;

// 前置：创建测试用户
beforeAll(async () => {
  const data = {
    pseudo: USER_PSEUDO,
    password: "123",
    date: "2022-08-29 16:31:25",
  };
  const url = `${API_URL}/register`;
  const response = await axios.post(url, data);
  expect(response.status).toBe(200);
  expect(response.data).toHaveProperty("token");
  TOKEN = response.data.token;
});

// 测试目标端点
test("POST/action test", async () => {
  const url = `${API_URL}/data/actions`;
  const data = {
    action: "running",
    date: "2021-09-30 18:14:24",
  };
  const headers = { Authorization: `Bearer ${TOKEN}` };
  const response = await axios.post(url, data, { headers });
  expect(response.status).toBe(200);
});

// 后置：清理数据库，无论测试成功失败都会执行
afterAll(async () => {
  // 避免用户创建失败时调用删除接口报错
  if (TOKEN) {
    const url = `${API_URL}/user/delete/all-data`;
    const headers = { Authorization: `Bearer ${TOKEN}` };
    try {
      await axios.delete(url, { headers });
    } catch (err) {
      console.error("清理测试数据失败:", err.message);
    }
  }
});

额外优化建议 #

• 测试隔离：每个测试文件用独立的唯一用户，保证14个测试文件之间互不影响
• 全局复用逻辑：如果所有测试文件都需要相同的创建/清理流程，可以把这些逻辑抽成单独模块，或者通过Jest的setupFilesAfterEnv配置全局钩子，减少重复代码
• 错误兜底：在清理逻辑里加try/catch，避免清理失败导致整个测试进程崩溃

之前代码失效的原因 #

Jest在加载测试文件时就会收集所有顶层的test()用例，而beforeAll是在测试执行阶段才运行，此时嵌套在钩子内部的test()不会被Jest识别，相当于没执行创建用户的逻辑，后续测试因为TOKEN为空直接失败。

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