本文详解如何在 Jest 测试中为同一被模拟函数（如 addNumbers）在不同测试用例中动态配置不同的 mockImplementation，解决因作用域错误导致的 “Cannot find function” 问题。
本文详解如何在 jest 测试中为同一被模拟函数（如 `addnumbers`）在不同测试用例中动态配置不同的 `mockimplementation`，解决因作用域错误导致的 “cannot find function” 问题。
在 Jest 单元测试中，我们常需对依赖模块中的函数进行模拟（mock），尤其当希望在不同测试用例中赋予其不同行为时（例如返回双倍和值、半差值等）。但若直接在 test() 块中调用未声明的 addNumbers.mockImplementation(...)，Jest 会报错：ReferenceError: addNumbers is not defined —— 这并非语法错误，而是作用域与模块引用缺失所致。
根本原因在于：jest.mock('./addFunc', ...) 创建的是一个模块级模拟对象，它不会将导出的函数自动挂载到全局或测试作用域；你必须通过导入该模块才能访问其模拟后的函数实例。
✅ 正确做法是：显式导入被模拟的模块，并通过模块对象访问其 mock 函数。以下是修正后的完整实践示例：
const request = require("supertest");
const app = require("../app");
// ✅ 关键步骤：导入被 mock 的模块，以获取对 mock 函数的引用
const addFunc = require("./addFunc");
// 模拟整个模块，初始化 addNumbers 为 jest.fn()
jest.mock("./addFunc", () => ({
addNumbers: jest.fn(),
}));
// 清理 mock 状态（推荐在每个测试前执行，避免状态污染）
beforeEach(() => {
addFunc.addNumbers.mockClear();
});
test("Testing add function with double result", async () => {
// ✅ 正确调用方式：通过模块对象访问并设置实现
addFunc.addNumbers.mockImplementation((a, b) => 2 * (a + b));
const res = await request(app).post("/addNumbers").send({ a: 1, b: 2 });
expect(res.status).toBe(200);
expect(res.body.result).toBe(6);
});
test("Testing add function with half result", async () => {
// ✅ 每个 test 可独立设置不同逻辑
addFunc.addNumbers.mockImplementation((a, b) => (a - b) / 2);
const res = await request(app).post("/addNumbers").send({ a: 6, b: 2 });
expect(res.status).toBe(200);
expect(res.body.result).toBe(2);
});⚠️ 注意事项：
- 拼写校验：mockImplementation 易误写为 mockImplentation（漏掉 "me"），Jest 不会报语法错误，但会导致静默失效，务必核对；
- 模块导入时机：require('./addFunc') 必须在 jest.mock() 之后执行，否则可能引入真实模块而非 mock 版本（Jest 文档明确建议 mock 调用置于 import 之前）；
- 状态隔离：多个测试共用同一 mock 函数，因此强烈建议在 beforeEach 中调用 .mockClear() 或 .mockReset()，防止前序测试影响后续行为；
- 类型安全（TypeScript 用户）：若使用 TS，可配合 jest.mocked() 工具函数增强类型推导，例如 const mockedAddFunc = jest.mocked(addFunc)。
总结：Jest 的模块模拟本质是“替换模块导出”，而非“注入全局变量”。要操控 mock 行为，就必须通过模块导入路径获取其引用。掌握这一机制，即可灵活实现 per-test 的 mock 实现切换，大幅提升测试覆盖率与场景表达能力。
