使用Sinon+Jest Mock类方法时触发真实方法的问题

嘿，我完全懂你这种在Jest和Sinon配合时Mock失效的头疼！我之前在Node项目里也踩过类似的坑，给你几个针对性的排查和解决办法：

1. 确认你正确Mock了类的原型方法 #

很多时候失效是因为Stub的是实例方法而不是原型方法——如果你的测试里是通过new MyClass()创建实例，那必须替换类原型上的方法才能让所有新实例生效。

举个实际代码例子：

const sinon = require('sinon');
const MyClass = require('./your-class-path');

test('should track method calls correctly', async () => {
  // 关键：Stub类原型上的目标方法
  const mockMyMethod = sinon.stub(MyClass.prototype, 'targetMethod')
    .resolves('fake-response'); // 根据方法是同步/异步选returns/resolves

  // 创建实例并调用方法
  const classInstance = new MyClass();
  await classInstance.targetMethod('test-param');

  // 验证调用统计
  sinon.assert.calledOnce(mockMyMethod);
  sinon.assert.calledWith(mockMyMethod, 'test-param');

  // 务必还原方法，避免污染其他测试用例
  mockMyMethod.restore();
});

2. 关闭Jest的自动Mock干扰 #

Jest默认会对导入的模块做自动Mock处理，这很可能和Sinon的Stub逻辑冲突。你可以在测试文件顶部加上这句，禁用目标模块的自动Mock：

jest.unmock('./your-class-path'); // 替换成你要Mock的类的路径

3. 用Sinon Sandbox管理Mock更可靠 #

手动一个个restoreStub容易遗漏，用Sinon的沙箱可以一次性还原所有Mock，还能避免测试用例之间的污染：

let sinonSandbox;

// 每个测试前创建沙箱
beforeEach(() => {
  sinonSandbox = sinon.createSandbox();
});

// 每个测试后清空沙箱
afterEach(() => {
  sinonSandbox.restore();
});

test('mock with sandbox', async () => {
  const mockMethod = sinonSandbox.stub(MyClass.prototype, 'targetMethod').returns('fake');
  const instance = new MyClass();
  instance.targetMethod();
  
  sinon.assert.calledOnce(mockMethod);
});

4. 针对ES模块的特殊处理 #

如果你用的是ES模块（import/export），要确保你导入的是真实的类，而不是Jest包装后的Mock对象。如果是默认导出的类，直接Stub原型方法即可；如果是命名导出，要注意导入的路径和对象：

import sinon from 'sinon';
import { MyClass } from './your-class-path'; // 命名导出的情况

test('mock ES module class', () => {
  const mockMethod = sinon.stub(MyClass.prototype, 'targetMethod').returns('fake');
  // ...后续逻辑和CommonJS一致
});

5. 排查代码内部的方法引用问题 #

如果你的类内部有直接绑定方法的操作（比如this.targetMethod = this.targetMethod.bind(this)），或者直接调用原始方法的逻辑，这会绕开原型上的Stub。这种情况下，你可以直接Stub实例本身的方法：

test('mock instance method directly', () => {
  const instance = new MyClass();
  const mockMethod = sinon.stub(instance, 'targetMethod').returns('fake');
  
  instance.targetMethod();
  sinon.assert.calledOnce(mockMethod);
});

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