Mock模块重置失败导致测试污染，本质是上一测试对jest.mock()、spyOn()或模块状态的修改未清理，影响后续测试；须按mock创建方式匹配重置：手动mock需jest.resetModules()+clearAllMocks()，spyon需mockRestore()，顶层mock应移入beforeEach或配unmock。
Mock 模块重置失败导致的测试污染，本质是上一个测试用例对 jest.mock()、jest.spyOn() 或模块内部状态的修改未被清理，影响了后续测试的行为和断言结果。排查关键在于确认 mock 是否真正还原、模块是否被重新加载、以及重置时机是否正确。
检查 mock 重置方式是否匹配 mock 创建方式
Jest 的 mock 重置有不同层级，必须与初始化方式对应：
-
手动 mock（
jest.mock('module')）：需在每个测试前用jest.resetModules()+jest.clearAllMocks()，否则模块缓存和 mock 实现仍保留；仅jest.clearAllMocks()不足以清除模块级 mock 替换。 -
自动 mock（
jest.mock('module', () => {...})）：同样依赖jest.resetModules()来清空require.cache，让下个测试重新执行 mock 定义。 -
spyon（
jest.spyOn(obj, 'method')）：必须显式调用mockRestore()（推荐在afterEach中），否则 spy 会持续劫持原方法。
确认测试文件顶部的 mock 是否被全局污染
如果在 describe 外或文件顶层写了 jest.mock()，它会在所有测试中生效且无法被单个 beforeEach 隔离。解决办法：
- 把
jest.mock()移到beforeEach内部（注意：仅限工厂函数形式，如jest.mock('fs', () => ({ readFileSync: jest.fn() }))）； - 若必须顶层 mock，搭配
jest.unmock('module')在特定测试中临时取消； - 避免在
setupFilesAfterEnv中无条件调用jest.mock()，除非明确需要全局 mock 且已处理重置逻辑。
验证模块是否真的被重新 require
即使调用了 jest.resetModules()，若模块被其他测试提前引入（比如通过工具函数、辅助类间接 require），缓存可能未被完全清除。可这样验证：
立即学习“Java免费学习笔记（深入）”；
- 在
beforeEach开头加console.log(require.cache)，观察目标模块路径是否出现在缓存中； - 在 mock 模块内部加
console.log('module loaded')，看是否只在首次 require 时打印； - 使用
jest.isolateModules(() => { require('./target') })强制隔离加载，适合调试单个测试。
用 jest.resetAllMocks() 和 jest.clearAllMocks() 的区别要分清
这两个方法常被误用：
-
jest.clearAllMocks()：只清空所有 mock 函数的调用记录（mock.calls、mock.instances等），不还原实现也不卸载模块； -
jest.resetAllMocks()：在clearAllMocks基础上，把 mock 实现重置为默认返回undefined，但依然不处理模块缓存； - 真正“重置模块级 mock”的组合是：
jest.resetModules(); jest.clearAllMocks();（顺序不能反）。
