本文详解如何在 Jest 中为同一被 mock 函数在不同测试用例中动态配置独立的 mockImplementation，解决因作用域错误导致的 “Cannot find function” 报错问题。
本文详解如何在 jest 中为同一被 mock 函数在不同测试用例中动态配置独立的 `mockimplementation`，解决因作用域错误导致的 “cannot find function” 报错问题。
在 Jest 单元测试中，我们常需对依赖模块中的函数进行模拟（mock），尤其当多个测试用例需要不同行为逻辑时（例如一个测试返回双倍和、另一个返回差值的一半），自然希望在每个 test() 块内单独调用 mockImplementation()。但若直接使用未声明的函数名（如 addNumbers.mockImplementation(...)），Jest 会报错：ReferenceError: addNumbers is not defined —— 这是因为 jest.mock() 创建的 mock 是模块级导出对象的一部分，并非全局变量，无法直接访问。
✅ 正确做法：通过导入模块实例访问 mock 函数
必须先 require（或 import）被 mock 的模块，再通过该模块对象访问其 mock 方法。这是关键所在：mock 函数仅存在于模块导出对象上，而非作用域顶层。
以下为修正后的完整示例：
const request = require("supertest");
const app = require("../app");
// ✅ 必须显式导入被 mock 的模块，以获取其 mock 实例
const addFunc = require("./addFunc");
// 全局 mock 模块：替换 ./addFunc 为含 jest.fn() 的模拟对象
jest.mock("./addFunc", () => ({
addNumbers: jest.fn()
}));
test("Testing add function with double result", async () => {
// ✅ 正确：通过 addFunc.addNumbers 访问 mock 函数
addFunc.addNumbers.mockImplementation((a, b) => 2 * (a + b));
const res = await request(app).post("/addNumbers").send({ a: 1, b: 2 });
expect(res.body.result).toBe(6);
});
test("Testing add function with half result", async () => {
// ✅ 同样通过模块实例调用，且可覆盖前一用例的实现
addFunc.addNumbers.mockImplementation((a, b) => (a - b) / 2);
const res = await request(app).post("/addNumbers").send({ a: 6, b: 2 });
expect(res.body.result).toBe(2);
});
⚠️ 关键注意事项
- 拼写校验：mockImplementation 易误写为 mockImplentation（漏掉 "me"），Jest 不会报语法错误，但调用无效 → 导致函数仍执行原始逻辑或 undefined，务必检查。
- 模块导入时机：require("./addFunc") 必须在 jest.mock() 之后执行，否则将获得原始模块而非 mock 版本（Jest 的 mock hoisting 机制要求 mock 声明优先）。
-
自动清理（推荐）：为避免测试间污染，可在 beforeEach 中重置 mock，或使用 mockReset() / mockRestore()：
beforeEach(() => { addFunc.addNumbers.mockReset(); // 清空调用记录与实现 }); - ESM 用户注意：若项目使用 ES Modules，应改用 import * as addFunc from "./addFunc" 并确保 jest.mock() 位置符合 ESM 规则（通常置于文件顶部，配合 jest.unstable_mockModule 或 Babel 插件）。
✅ 总结
“Cannot find function” 的根本原因不是 Jest 配置错误，而是 JavaScript 作用域理解偏差：jest.mock() 创建的是模块导出对象上的属性，而非全局绑定。只要坚持「先 mock → 再 import → 最后通过模块对象调用 mock 方法」这一流程，并注意拼写与清理，即可安全、灵活地为每个测试用例定制函数行为，大幅提升测试覆盖率与可维护性。
