为何Jest在多测试文件场景下未并行执行测试用例？

可能导致串行的核心原因 #

• 通用方法的全局副作用/资源竞争：如果你的通用方法涉及全局变量修改、共享资源（如数据库连接、文件锁、全局状态），Jest为避免测试污染，会自动将这类测试串行化。比如通用方法操作了同一个全局对象，或占用了仅支持单实例运行的资源，Jest会检测到并强制串行，防止测试结果互相干扰。
• Jest配置被意外限制：检查jest.config.js中的maxWorkers字段，若被设为1，会强制所有测试串行执行。默认值应为os.cpus().length - 1或'50%'，确保未被修改。
• 测试文件间的隐式依赖：若通用方法的初始化/清理逻辑未做隔离，导致测试文件间共享环境状态（比如某个文件的测试修改了另一个文件依赖的配置），Jest的依赖检测机制会强制串行执行这些文件。
• 第三方库的单例限制：如果通用方法依赖的第三方库是单例模式（如部分SDK、缓存库），这类库本身不支持多实例并行运行，会导致Jest无法并行执行调用该库的测试文件。

快速排查步骤 #

1. 单独运行两个不同的测试文件：执行jest file1.test.js file2.test.js，观察是否仍串行。若串行，说明这两个文件存在冲突点。
2. 检查通用方法实现：确认是否存在全局状态修改、共享资源未在beforeEach/afterEach中清理的情况。
3. 验证Jest配置：查看jest.config.js，确保maxWorkers未被限制为1。
4. 强制模块隔离：尝试用jest.isolateModules(() => { /* 通用方法调用逻辑 */ })包裹测试中的通用方法调用，强制隔离模块环境，看是否恢复并行。

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