Jest测试中模块状态未重置导致用例失败问题求助

看起来你遇到的是Jest模块缓存导致的测试污染问题——虽然用了jest.resetModules()，但模块的状态还是在测试之间保留了，这是很常见的坑。我来帮你拆解原因和解决方案：

核心原因 #

Jest会缓存已加载的模块，当你在测试文件顶部require模块时，这个模块（包括它依赖的dependency.js）只会被加载一次。哪怕你调用了jest.resetModules()，如果后续没有重新require模块，还是会用之前缓存的实例，状态自然就残留了。

另外，如果dependency.js本身是有状态的单例（比如内部有全局变量、计数器），即使重新加载模块，有些环境下可能还是会保留之前的状态？其实jest.resetModules()会清除模块缓存，重新require会加载新的模块实例，但前提是你要在每次测试里动态require，而不是在文件顶部提前加载。

解决方案 #

1. 在每个测试中动态加载模块 #

不要在测试文件的顶部提前require你的MyModule和依赖，而是在每个test块内部调用jest.resetModules()之后再require，这样每次测试都会拿到全新的模块实例：

// 不要在顶部require！
// const MyModule = require('./MyModule');

test('第一次调用计数应为2', () => {
  jest.resetModules();
  // 每次测试里动态加载
  const MyModule = require('./MyModule');
  
  MyModule.doSomething(); // 假设这个方法会调用dependency两次
  expect(MyModule.getCount()).toBe(2);
});

test('第二次调用计数仍应为2', () => {
  jest.resetModules();
  const MyModule = require('./MyModule');
  
  MyModule.doSomething();
  expect(MyModule.getCount()).toBe(2);
});

2. 模拟有状态的依赖（更可靠的方案） #

如果dependency.js本身带有状态，直接重置模块可能不够灵活，最好用Jest的jest.mock()来模拟这个依赖，完全控制它的状态：

比如先给dependency.js加个重置方法（或者在mock里实现）：

// dependency.js
let count = 0;
module.exports = {
  increment: () => count++,
  getCount: () => count,
  reset: () => { count = 0; } // 新增重置方法
};

然后在测试文件里mock这个依赖，并在每个测试前重置状态：

// 提前mock依赖
jest.mock('./dependency', () => {
  let count = 0;
  return {
    increment: () => count++,
    getCount: () => count,
    reset: () => { count = 0; }
  };
});

// 每个测试前重置状态并重置模块
beforeEach(() => {
  jest.resetModules();
  const dependency = require('./dependency');
  dependency.reset();
});

test('第一次测试计数正确', () => {
  const MyModule = require('./MyModule');
  MyModule.doSomething();
  expect(MyModule.getCount()).toBe(2);
});

test('第二次测试计数不受影响', () => {
  const MyModule = require('./MyModule');
  MyModule.doSomething();
  expect(MyModule.getCount()).toBe(2);
});

3. 让你的模块支持无状态实例化 #

如果MyModule本身是单例模式，每次require都返回同一个实例，那即使重置模块缓存，可能还是会有状态残留。这时候可以修改MyModule，让它返回一个工厂函数，每次调用都创建新实例：

// MyModule.js
module.exports = () => {
  const dependency = require('./dependency');
  
  return {
    doSomething: () => {
      dependency.increment();
      dependency.increment();
    },
    getCount: () => dependency.getCount()
  };
};

然后测试时每次调用工厂函数获取新实例：

test('第一次测试', () => {
  jest.resetModules();
  const createMyModule = require('./MyModule');
  const myModule = createMyModule();
  
  myModule.doSomething();
  expect(myModule.getCount()).toBe(2);
});

test('第二次测试', () => {
  jest.resetModules();
  const createMyModule = require('./MyModule');
  const myModule = createMyModule();
  
  myModule.doSomething();
  expect(myModule.getCount()).toBe(2);
});

总结 #

最关键的两点：

• 不要在测试文件顶部提前加载模块，而是在每个测试里动态require
• 对于有状态的依赖，要么重置它的状态，要么用mock完全控制它的行为

这样就能彻底解决测试之间的状态污染问题了。

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