本文详解如何在 Jest 测试中为同一被模拟函数（如 addNumbers）在不同测试用例中设置独立的 mockImplementation，解决因作用域缺失导致的 “Cannot find function” 报错问题。
本文详解如何在 jest 测试中为同一被模拟函数（如 `addnumbers`）在不同测试用例中设置独立的 `mockimplementation`，解决因作用域缺失导致的 “cannot find function” 报错问题。
在 Jest 单元测试中，常需对同一依赖函数在不同测试场景下提供差异化行为（例如返回双倍和半值结果）。但若仅通过 jest.mock() 声明模拟模块，却直接在 test() 内部调用未声明的函数名（如 addNumbers.mockImplementation(...)），会触发 ReferenceError: addNumbers is not defined —— 因为 addNumbers 并非全局变量，而是被模拟模块导出的属性，必须通过导入该模块后以属性访问形式调用。
✅ 正确做法：显式导入被模拟模块，再访问其 mocked 函数
你需要在测试文件顶部同时完成两件事：
- 使用 jest.mock('./addFunc') 模拟模块行为；
- 使用 const addFunc = require('./addFunc')（或 import addFunc from './addFunc'）导入该模块，从而获得对 addFunc.addNumbers 的引用。
这样，addFunc.addNumbers 才是 Jest 实际创建并管理的 mock 函数实例，支持在每个 test 中安全调用 .mockImplementation()。
以下是修正后的完整示例代码（含语法修复与最佳实践）：
const request = require('supertest');
const app = require('../app');
const addFunc = require('./addFunc'); // ✅ 必须显式导入，才能访问 mock 函数
// 模拟整个模块，仅导出 addNumbers 且初始化为 jest.fn()
jest.mock('./addFunc', () => ({
addNumbers: jest.fn(),
}));
// 可选：在每个 test 前重置 mock 状态，避免副作用干扰
beforeEach(() => {
addFunc.addNumbers.mockReset();
});
test('Testing add function with double result', async () => {
// ✅ 正确调用：通过导入对象访问 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);
});⚠️ 关键注意事项
- 拼写校验：原代码中 mockImplentation 是错误拼写，正确为 mockImplementation（注意 me）；
- 避免污染：建议在 beforeEach 中调用 .mockReset() 或 .mockClear()，确保每个测试用例从干净状态开始；
- ESM 兼容性：若项目使用 ES Modules（type: "module"），请改用 import 语法，并注意 jest.mock() 在 ESM 中需置于顶层且不可条件执行（推荐搭配 jest.unstable_mockModule 或迁移至 require 风格）；
- 类型安全（TypeScript）：可为 addFunc 添加类型断言，例如 const addFunc = require('./addFunc') as typeof import('./addFunc');，提升开发体验。
✅ 总结
Jest 的模块级 mock 不会将导出函数自动挂载到全局作用域；要动态配置其实现逻辑，必须通过导入模块对象来访问对应的 mock 函数实例。掌握这一模式，即可灵活实现“单函数多行为”的精细化测试控制，大幅提升测试覆盖率与可维护性。
