Mocha/Sinon Stub恢复失效求助：二次测试无法识别Stub

嘿，我来帮你排查第二个测试识别不了Sinon Stub的问题！结合你用的Mocha 5.0.2、Sinon 4.4.2和Node v8.1.3，这类问题大多和Stub的作用域、模块缓存或者测试间的状态清理有关，我给你列几个最常见的误区和解决办法：

1. 模块缓存导致Stub状态未重置 #

Node.js会缓存require导入的模块，如果你在测试文件顶部直接const util = require('./util')，第一个测试里修改的Stub会保留在缓存的模块对象上——但如果第一个测试结束后你恢复了Stub，第二个测试就会拿到未被Stub的原始方法；反之如果没恢复，第二个测试的Stub状态会和第一个测试混在一起。

解决办法：

• 在每个测试前重新获取模块（可以用delete require.cache[require.resolve('./util')]清除缓存后再导入）；
• 更规范的做法是在afterEach钩子中用sinon.restore()重置所有Stub，确保每个测试都是独立的：

  let util;
  beforeEach(() => {
    delete require.cache[require.resolve('./util')];
    util = require('./util');
    sinon.stub(util, 'sendToQueue').resolves();
  });
  
  afterEach(() => {
    sinon.restore(); // 重置所有Sinon创建的Stub、Spy等
  });
  

2. Stub的作用域不匹配 #

这是最容易踩的坑！如果你的业务代码或util.js里的函数引用方式不对，Stub根本不会生效：

• 比如util.js里导出了函数，但业务代码里直接引用了局部定义的函数，而非导出的对象：

  // util.js 错误示例
  function sendToQueue() { /* 队列发送逻辑 */ }
  module.exports = { sendToQueue };
  
  // 业务代码 错误示例
  const { sendToQueue } = require('./util');
  function myFunc() {
    sendToQueue(); // 这里调用的是局部变量，不是导出对象上的方法，Stub无效
  }
  

• 或者你Stub的是模块的默认导出，而非命名导出，搞反了对象层级。

解决办法：

• 让业务代码始终通过模块对象调用方法：const util = require('./util'); util.sendToQueue()；
• 确认Stub的目标是正确的导出对象（比如sinon.stub(util, 'sendToQueue')对应命名导出，sinon.stub(util.default)对应默认导出）。

3. 异步测试未正确处理 #

如果你的队列发送函数是异步的，测试里没正确等待异步操作完成，会导致Stub的调用记录还没生成就执行了断言，看起来像是Stub没被识别。

解决办法：

• 在Mocha测试中，要么返回Promise，要么调用done回调：

  it('should send message to queue', async () => {
    await myFunc(); // 等待异步函数完成
    expect(util.sendToQueue.calledOnce).to.be.true;
  });
  
  // 或者用done回调
  it('should send message to queue', (done) => {
    myFunc().then(() => {
      expect(util.sendToQueue.calledOnce).to.be.true;
      done();
    }).catch(done);
  });
  

4. Stub创建时机错误 #

如果你的第二个测试里没有重新创建Stub，或者Stub是在before钩子中只创建一次，第一个测试修改了Stub的状态（比如调用了stub.restore()），第二个测试就会用原始方法。

解决办法：

• 在beforeEach钩子中创建Stub，确保每个测试都有全新的Stub实例：

  let sendToQueueStub;
  beforeEach(() => {
    sendToQueueStub = sinon.stub(util, 'sendToQueue').resolves('success');
  });
  

你可以先对照这几点检查你的代码，尤其是模块导入方式和Stub的作用域，这两个是最常见的问题！

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