Jest Supertest批量运行测试失败 单独运行均通过问题排查

Jest 默认会跨测试文件并行执行测试：

• 单个测试文件内的test/it用例默认串行执行
• 批量运行时Jest会根据CPU核心数启动对应数量的worker进程，不同测试文件分配到不同worker上同时运行，默认worker数通常是CPU核心数-1

你遇到的批量运行数据污染、单独运行全正常的问题，就是多worker并行访问同一个PostgreSQL数据库导致的：多个测试文件同时读写表、触发各自的afterAll清表逻辑，操作时序完全交叉，才会出现测试读到其他用例写入的数据、单独运行时清表逻辑正常无残留的现象。

• 临时串行执行：运行命令加--runInBand参数，强制所有测试在同一个进程内串行执行，完全关闭并行worker，命令如下：

  npx jest --runInBand
  

• 永久配置串行：在项目的Jest配置文件（jest.config.js/jest.config.ts）中添加配置，把并行worker数强制设为1：

  module.exports = {
    // 你项目里原有的其他Jest配置
    maxWorkers: 1,
  }
  

  如果你是在package.json中配置Jest，直接在jest配置块下添加"maxWorkers": 1即可，效果和--runInBand完全一致。

仅关闭并发虽然能解决问题，但测试执行速度会随用例增多明显变慢，更稳妥的防污染方案可以参考：

• 把清表逻辑从afterAll移到beforeEach：每个用例执行前先清空依赖的数据表，相比执行后清表，能避免测试中途报错、进程异常退出导致的脏数据残留，保证每个用例启动时环境是干净的
• 用事务回滚替代删表：每个测试用例启动时开启数据库事务，用例执行完成后直接回滚事务，相比全表删除执行效率更高，也不会产生数据残留
• 多测试文件隔离测试库：如果后续测试量增大，可以给每个并行的worker分配独立的临时测试库，测试跑完后直接删除临时库，既保留Jest并行执行的速度优势，又完全不会出现跨测试数据干扰

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