如何使用Jest和CommonJS模拟命名导出uuidv4？

你遇到的核心问题是：测试文件中解构得到的uuidv4和myModule内部引用的uuidv4不是同一个变量引用，直接赋值jest.fn()只会修改测试文件里的变量，无法影响模块内部的调用。以下是两种无需手动创建mock文件的可行方案：

方案一：用jest.mock直接Mock整个uuid模块 #

这种方式会替换uuid模块的导出，让myModule加载的是mock版本的v4函数：

// myModule.test.js
const myModule = require('./myModule');
const { v4: uuidv4 } = require('uuid');

// Mock整个uuid模块，返回包含mock v4函数的对象
jest.mock('uuid', () => ({
  v4: jest.fn()
}));

describe('Tests for myModule', () => {
  test('First test', async () => {
    // 设置mock返回值
    uuidv4.mockReturnValueOnce("custom-uuid");

    await myModule.someFunction();

    expect(uuidv4).toHaveBeenCalled();
  });
});

方案二：用jest.spyOn拦截uuid模块的v4方法 #

通过spyOn直接修改uuid模块导出的v4函数，确保myModule内部的引用也会指向被拦截后的函数：

// myModule.test.js
const myModule = require('./myModule');
const uuid = require('uuid'); // 不要解构，保留模块引用

describe('Tests for myModule', () => {
  test('First test', async () => {
    // 拦截uuid模块的v4方法
    const uuidSpy = jest.spyOn(uuid, 'v4').mockReturnValueOnce("custom-uuid");

    await myModule.someFunction();

    expect(uuidSpy).toHaveBeenCalled();
    // 可选：测试结束后恢复原函数，避免影响其他测试
    uuidSpy.mockRestore();
  });
});

为什么原有方法无效？ #

在CommonJS模块加载机制中，myModule执行const {v4: uuidv4} = require('uuid')时，会直接获取uuid模块导出的v4函数的引用并存在自己的作用域里。你在测试文件中解构得到的uuidv4是另一个变量，直接赋值jest.fn()只会覆盖测试文件里的变量，无法修改myModule作用域内的引用，所以mock不会生效。

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