Jest.unmock无法接收变量传参的解决方案及原理咨询

我之前也碰到过这个坑，刚好研究过 Jest 的模块 mock 机制，给你理清楚可行的解决方案和背后的原因：

可行的解决方案 #

1. 修正你的 eval 写法（最简单的临时方案）

你之前的 eval 用法有个小错误——你把带引号的字符串传进去了，导致执行的是 jest.unmock("'got'")，自然找不到模块。改成下面这样就可以正常工作：

const mod = 'got';
eval(`jest.unmock('${mod}')`);

因为 Jest 的预扫描会解析 eval 里的静态字符串，这样写就和直接写字面量调用完全一致了。

2. 手动操作 Jest 的内部缓存（更可靠的进阶方案）

如果不想用 eval，你可以直接操作 Jest 的模块缓存和 mock 注册表，强制取消模块的 mock 状态：

function unmockModule(moduleName) {
  // 从 Jest 的 mock 注册表中移除该模块的 mock 规则
  jest.mockRegistry.delete(moduleName);
  // 清除 Node.js 的模块缓存，避免已经加载的 mock 版本残留
  delete require.cache[require.resolve(moduleName)];
  // 最后调用 unmock 确保后续加载的是原始模块
  jest.unmock(moduleName);
}

// 使用示例
const mod = 'got';
unmockModule(mod);

注意：这个方法依赖 Jest 的内部 API（jest.mockRegistry），虽然目前几个稳定版本都能用，但未来如果 Jest 调整内部实现可能会失效，不过对于批量 unmock 场景来说还是很实用的。

3. 借助 Babel 插件实现批量 unmock（适合项目级别的方案）

如果你的项目用了 babel-jest，可以用专门的 Babel 插件，直接支持数组批量传入：

jest.unmock(['got', 'axios', 'lodash']);

插件会在编译阶段把数组转成多个单独的 jest.unmock 字面量调用，完美规避静态分析的限制。

为什么 Jest 只接受字符串字面量？ #

这个限制是 Jest 的静态预扫描机制导致的：

• Jest 在运行测试代码之前，会先做一次静态代码分析，扫描所有文件里的 jest.mock、jest.unmock 等调用，提前构建模块的 mock 规则。这个阶段根本不会执行代码，只会解析代码的 AST 语法树。
• 变量、表达式这类动态内容在静态分析阶段无法被解析出具体值，Jest 不知道你要 unmock 哪个模块，自然不会生效。
• 这种设计是为了保证模块加载的确定性：如果允许动态变量，Jest 无法提前确定 mock 规则，可能导致模块已经被 mock 版本加载后，才执行 unmock 操作，完全失去了 unmock 的意义。

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