Node.js应用改造中Mock函数内Promise Resolve失效问题求助

老兄，我太懂这种刚碰Promise和async/await时踩的坑了！你遇到的await“不等待”问题，十有八九是Mock的异步方法没写对——毕竟把旧代码迁到类+async/await的现代语法时，很容易在Mock异步逻辑上掉链子。我给你拆解几个最常见的问题和修复方案：

一、先查Mock的核心：异步方法是否返回Promise？ #

很多时候await白等，本质是你的Mock方法根本没返回真正的Promise，或者写的是“假异步”。比如这种错误写法：

// 错误示范：Mock方法直接返回普通对象，不是Promise
jest.mock('./persistence', () => {
  return class MockPersistence {
    getData() {
      return { id: 1, name: 'test' }; // 这里没有异步任务，await直接拿结果，等于没等
    }
  };
});

正确的做法是让Mock方法返回Promise，最简单的方式就是用async修饰方法（async函数会自动返回Promise）：

// 正确示范：Mock异步方法返回Promise
jest.mock('./persistence', () => {
  return class MockPersistence {
    async getData() {
      return { id: 1, name: 'test' }; // async自动包裹成resolved的Promise
    }
    // 或者手动返回Promise也可以
    updateData(data) {
      return Promise.resolve({ success: true });
    }
  };
});

二、测试用例必须标记为async #

如果你的测试函数没加async，测试框架（比如Jest、Mocha）根本不会等await执行完，直接就结束测试了！比如：

// 错误示范：测试函数没加async，await会报错，测试直接终止
test('should fetch data correctly', () => {
  const persistence = new MockPersistence();
  const result = await persistence.getData(); // 这里直接炸
  expect(result.id).toBe(1);
});

// 正确示范：给测试函数加async，框架会自动等待所有await完成
test('should fetch data correctly', async () => {
  const persistence = new MockPersistence();
  const result = await persistence.getData();
  expect(result.id).toBe(1);
});

三、用Sinon等Mock库？别忘用resolves/stubs异步方法 #

如果你用Sinon这类Mock库，要记得给stub的方法指定Promise返回值，别直接返回普通值：

const sinon = require('sinon');
const Persistence = require('./persistence');

test('should handle data update', async () => {
  // 创建Stub实例
  const mockPersistence = sinon.createStubInstance(Persistence);
  // 用resolves指定异步方法返回的Promise结果
  mockPersistence.updateData.resolves({ success: true });

  // 注入Mock到你的业务类
  const service = new YourBusinessService(mockPersistence);
  const result = await service.updateItem({ id: 1 });
  
  expect(result.success).toBe(true);
  // 还能验证方法是否被正确调用
  expect(mockPersistence.updateData.calledOnceWith({ id: 1 })).toBe(true);
});

四、迁移代码时的小提醒：别漏await #

在把旧的Promise链式调用改成async/await时，一定要确保每一步异步操作都加了await，不然会拿到一个未解决的Promise对象：

// 旧代码（Promise链式）
persistence.getData()
  .then(data => persistence.updateData(data))
  .then(result => console.log(result))
  .catch(err => console.error(err));

// 新代码（async/await）
async function processData() {
  try {
    const data = await persistence.getData();
    const result = await persistence.updateData(data); // 这里必须加await！不然result是Promise
    console.log(result);
  } catch (err) {
    console.error(err);
  }
}

要是你能把具体的Mock代码和测试片段贴出来，我还能帮你精准定位，但上面这几个点应该能解决大部分“await不等待”的Mock问题了！

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