Jest模拟Promise方法调用次数不符问题排查求助

我之前也碰到过类似的异步链式请求测试坑，这种依赖前序Promise结果的场景，很容易因为测试里没处理好异步逻辑，导致mock的调用次数和预期不符。咱们一步步来排查解决：

先明确核心问题根源 #

你遇到的"期望调用3次但实际1次"，大概率是这两个原因之一：

1. 测试没等完所有异步操作就执行断言：Jest默认同步执行，要是你的Action里的Promise链还没走完，测试就结束了，后面的apiCall自然没机会执行。
2. mock的Promise没返回正确的resolved值：后续请求依赖前一次的返回值，如果mock没给出对应结果，链式调用的后续逻辑会直接卡住，不会触发下一次apiCall。

具体解决步骤+示例代码 #

1. 确保测试正确等待异步操作完成

不管你的Action用的是async/await还是.then()链式写法，测试都必须等整个Promise链执行完毕再断言。这里推荐用async/await，代码更清晰：

假设你的Redux Action是这样的（链式依赖前序结果）：

// actions.js
export const sequentialApiAction = () => async (dispatch) => {
  // 第一次请求，返回id
  const firstRes = await apiCall('/api/first');
  // 第二次用firstRes的id请求
  const secondRes = await apiCall('/api/second', firstRes.id);
  // 第三次用secondRes的data请求
  await apiCall('/api/third', secondRes.data);
  
  dispatch({ type: 'SEQUENTIAL_SUCCESS' });
};

对应的Jest测试要这么写：

// actions.test.js
import { sequentialApiAction } from './actions';
import apiCall from './apiCall';

// 先mock apiCall模块
jest.mock('./apiCall');

describe('sequentialApiAction', () => {
  beforeEach(() => {
    // 每次测试前重置mock，避免脏数据
    apiCall.mockClear();
    // 给mock设置依次返回的结果，匹配Action里的依赖逻辑
    apiCall
      .mockResolvedValueOnce({ id: 100 }) // 第一次请求的返回值
      .mockResolvedValueOnce({ data: 'user-info' }) // 第二次的返回值
      .mockResolvedValueOnce({ status: 'ok' }); // 第三次的返回值
  });

  it('应该按顺序调用apiCall三次，且参数正确', async () => {
    const mockDispatch = jest.fn();
    
    // 关键：用await等待整个Action的异步逻辑执行完毕
    await sequentialApiAction()(mockDispatch);

    // 现在断言就准确了
    expect(apiCall).toHaveBeenCalledTimes(3);
    // 还可以验证每次调用的参数是否符合预期
    expect(apiCall).toHaveBeenNthCalledWith(1, '/api/first');
    expect(apiCall).toHaveBeenNthCalledWith(2, '/api/second', 100);
    expect(apiCall).toHaveBeenNthCalledWith(3, '/api/third', 'user-info');
  });
});

2. 排查Promise链中的错误分支

如果你的Action里有错误捕获逻辑，某个请求reject会导致后续请求中断，这时候也会出现调用次数不足的情况。可以加个测试验证错误场景：

it('当中间请求失败时，应该停止后续调用', async () => {
  const mockDispatch = jest.fn();
  apiCall
    .mockResolvedValueOnce({ id: 100 })
    .mockRejectedValueOnce(new Error('API请求失败'));

  // 验证Action会抛出错误
  await expect(sequentialApiAction()(mockDispatch)).rejects.toThrow('API请求失败');
  // 此时apiCall应该只被调用2次
  expect(apiCall).toHaveBeenCalledTimes(2);
});

额外注意点 #

• 如果你的Action用的是.then()链式写法而非async/await，测试时要确保返回整个Promise链，或者用await等待，原理和上面一致。
• 每次测试前一定要用mockClear()重置mock，避免前一次测试的调用记录影响当前结果。

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