Sinon stub.resolves()不符合预期，测试断言桩函数未被调用求助

嘿，我太懂这种明明业务代码跑起来没问题，测试却跟你“闹脾气”的憋屈感了！针对你遇到的Sinon桩函数完全未被调用的问题，结合Promise与Sinon的常见坑点，我整理了几个优先级最高的排查方向，你可以逐一验证：

1. 测试没等Promise执行完就提前断言 #

这是最常见的问题！如果你的函数依赖Promise异步逻辑，但测试是同步写的，测试框架会在Promise的微任务执行前就跑完断言，自然看不到桩函数被调用。

错误示例：

it("should trigger the stub", () => {
  const myStub = sinon.stub();
  myAsyncFunction(myStub); // 这个函数内部返回Promise
  sinon.assert.called(myStub); // 断言时Promise还没执行完，必败！
});

修正方案：用async/await或者返回Promise让测试框架等待异步操作结束：

it("should trigger the stub", async () => {
  const myStub = sinon.stub();
  await myAsyncFunction(myStub); // 等待Promise完成
  sinon.assert.called(myStub); // 现在能拿到正确的调用状态
});

2. Promise链里的错误被吞掉，导致桩函数分支没执行 #

如果你的Promise链中出现未捕获的错误，后续调用桩函数的代码会直接跳过。比如：

function myAsyncFunction(stub) {
  fetchSomeData()
    .then(data => {
      if (!data.valid) throw new Error("Invalid data"); // 抛出错误
      stub(data); // 这行代码永远不会执行
    });
}

排查方式：

• 在测试中监听Promise的reject，比如用await myAsyncFunction().catch(err => console.log(err))，看看是不是有隐藏错误。
• 确保Promise链的每个分支都被覆盖到（包括错误分支）。

3. 桩函数的匹配条件太严格 #

有时候你以为桩函数会被调用，但实际传入的参数和你预设的不匹配，Sinon会判定为“未调用”。

排查方式：

• 先放宽匹配条件，用sinon.assert.calledWith(myStub, sinon.match.any)验证桩函数是否真的没被调用。
• 如果放宽条件后测试通过，再逐步细化参数匹配规则，检查实际传入的参数和预期是否一致。

4. 桩函数没有正确替换目标对象/函数 #

如果你的桩函数没有绑定到正确的目标对象上，相当于你在测试一个“假”的函数。比如：

• 如果目标函数是模块导出的，要确保你stub的是模块上的函数，而不是本地引用：

  // 错误：stub的是本地变量，不是模块导出的函数
  import { targetFunc } from "./utils";
  const stub = sinon.stub().returns(Promise.resolve());
  
  // 正确：直接stub模块上的函数
  import * as utils from "./utils";
  const stub = sinon.stub(utils, "targetFunc").returns(Promise.resolve());
  

5. 异步执行顺序问题 #

在Node.js或者浏览器环境中，Promise的微任务会在同步代码之后、宏任务之前执行。如果你的测试中有其他异步操作干扰，可能导致桩函数的调用时机晚于断言。

临时验证方案：用setImmediate推迟断言（仅用于排查，不建议作为最终解决方案）：

it("should trigger the stub", (done) => {
  const myStub = sinon.stub();
  myAsyncFunction(myStub);
  setImmediate(() => {
    sinon.assert.called(myStub);
    done();
  });
});

如果以上方向都排查完还是有问题，建议贴出你的业务函数和测试代码的关键片段，这样能更精准定位问题~

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