如何为 Jest 中每个 it() 测试用例独立配置模块 mock？

本文共计772个文字，预计阅读时间需要4分钟。

使用`jest.mock()`的默认行为是模块级别的静态替换，无法直接在`it()`内动态地重定义；正确的做法是顶层使用`jest.mock()`配合`jest.spyOn()`动态覆盖，并在`afterEach()`中进行清理，从而为每个测试用例独立定制mock行为。

在 Jest 单元测试中，若需为不同 it() 测试用例提供完全独立、互不干扰的模块 mock 实现（例如模拟中间件 awsTransferMiddleware 的不同行为），直接在 it() 内多次调用 jest.mock() 是无效的——因为 jest.mock() 是 hoisted 且仅在模块初始化时生效，重复调用不会覆盖已注册的 mock。

✅ 正确且推荐的实践方案如下：

1. 顶层静态 mock（必需）

首先在文件顶部执行 jest.mock()，强制 Jest 替换目标模块为自动 mock（auto-mock）版本。这一步不可省略，否则 require() 将加载真实模块：

// 顶部：启用自动 mock（不提供实现，仅生成 jest.fn() 占位符） jest.mock('../../../middleware/awsTransferMiddleware');

2. 显式导入被 mock 模块并动态控制行为

由于自动 mock 会将模块导出全部转为 jest.fn()，我们需显式导入它，并在每个 it() 中通过 jest.spyOn() 或直接赋值来定制具体函数的行为：

const awsTransferMiddleware = require('../../../middleware/awsTransferMiddleware'); // 注意：此处 import/require 必须在 jest.mock() 之后，确保拿到的是 mock 版本

3. 每个 it() 内独立配置 mock 实现

利用 jest.fn().mockImplementation() 为每个测试用例设置专属逻辑。推荐直接覆写导出对象的属性（更直观），而非 spyOn（因 auto-mock 已是 mock 函数）：

it("Should return a 200 status code if at least one image exists in the temp directory.", async () => { // ✅ 覆盖指定方法的实现（仅影响当前 test） awsTransferMiddleware.transferS3Files.mockImplementation(async (req, res, next) => { // 模拟成功上传场景 req.uploadedFiles = [{ key: 'img1.jpg', size: 1024 }]; next(); }); awsTransferMiddleware.filterPassedImage.mockImplementation(async (req, res, next) => { req.filteredImages = req.uploadedFiles; next(); }); const response = await request(app).post('/upload'); expect(response.status).toBe(200); }); it("Should return 400 if no images pass filtering.", async () => { // ✅ 完全不同的行为：模拟过滤后无有效图片 awsTransferMiddleware.transferS3Files.mockImplementation(async (req, res, next) => { req.uploadedFiles = [{ key: 'doc.pdf', size: 2048 }]; next(); }); awsTransferMiddleware.filterPassedImage.mockImplementation(async (req, res, next) => { req.filteredImages = []; res.status(400).json({ error: 'No valid images' }); }); const response = await request(app).post('/upload'); expect(response.status).toBe(400); });

4. 全局清理保障隔离性（关键！）

在 afterEach 中调用 jest.clearAllMocks()（或 jest.restoreAllMocks()），确保每个测试用例从干净状态开始：

afterEach(() => { jest.clearAllMocks(); // 重置所有 mock 的调用记录和返回值 });

通过以上四步，你就能在保持测试高度隔离的同时，为每个业务场景精准构造中间件行为，真正实现“一测一模”，大幅提升端到端 API 测试的覆盖率与可维护性。