为什么Jest Mock不在it作用域声明就不生效？如何统一配置Mock实现

你遇到的问题本质是Mock实现绑定的时序错位：

• 你把RestUserAPIMock.mockImplementation(...)写在了模块顶层，这段代码会在所有测试钩子执行前就运行，给Mock类绑定好自定义的构造返回值。
• 后续进入测试流程时，beforeAll钩子中调用的RestUserAPIMock.mockClear()，会将Jest自动生成的类Mock状态重置：构造函数不再返回你自定义的带getName方法的对象，原型上的方法也会回到默认返回undefined的自动Mock状态，最终测试断言失败。
• 而你把mockImplementation写在单个it块里能正常运行，是因为这段代码在beforeAll的清理逻辑执行完成后才运行，绑定的Mock实现不会被重置，所以能生效。

注：按照Jest的设计，mockClear()仅用于清理Mock函数的调用记录、实例记录，不会主动清除通过mockImplementation设置的自定义实现。但对于Jest自动生成的类Mock，内部会为每个原型方法维护独立的Mock实例，类级别的mockClear()会重置这些独立方法的状态，连带将构造函数的默认返回值改回自动生成的空Mock实例。

你可以根据自己的需求选择下面任意一种方案，实现所有测试块共享同一份Mock逻辑，不需要在每个it块里重复写实现：

方案1：在生命周期钩子中绑定实现（最小改动） #

将原来在顶层写的mockImplementation代码，移动到beforeAll钩子里、在mockClear()调用之后执行。这样每次测试流程启动时，会先完成Mock状态清理，再绑定全局生效的统一实现，所有后续的it块都能直接复用。
示例代码：

import { UserService } from './UserService';
import { RestUserAPI } from "./RestUserAPI";

const mockedUserName = 'mocked user name'

jest.mock('./RestUserAPI');
const RestUserAPIMock = RestUserAPI as jest.MockedClass<typeof RestUserAPI>;

describe("User Service", () => {
  let instance: UserService;
  beforeAll(() => {
    // 第一步：清理旧的Mock调用记录
    RestUserAPIMock.mockClear()
    // 第二步：清理完成后绑定全局生效的统一Mock实现
    RestUserAPIMock.mockImplementation(() => {
      return {
        getName: jest.fn().mockReturnValue(mockedUserName),
      };
    });
  });

  it("should get user name", () => {
    instance = new UserService();
    expect(instance.getName()).toBe(mockedUserName);
    expect(RestUserAPIMock).toHaveBeenCalledTimes(1);
  });

  // 后续新增的所有it块，都不需要重复配置Mock实现
  it("can get user name in another scenario", () => {
    instance = new UserService();
    expect(instance.getName()).toBe(mockedUserName);
  });
});

方案2：通过jest.mock工厂函数绑定实现（最稳妥） #

直接给jest.mock()传入工厂函数，在模块加载阶段就完成Mock类的替换和实现绑定，彻底避免执行顺序、提升导致的时序问题。这种方式配置的Mock实现不会被后续的mockClear()意外清除，是Jest官方推荐的跨测试块共享Mock的写法。
示例代码：

import { UserService } from './UserService';

const mockedUserName = 'mocked user name'

// 模块加载时就完成Mock替换，绑定统一实现
jest.mock('./RestUserAPI', () => ({
  RestUserAPI: jest.fn().mockImplementation(() => ({
    getName: jest.fn().mockReturnValue(mockedUserName)
  }))
}));

// 拿到已经完成实现绑定的Mock类
const RestUserAPIMock = jest.mocked(RestUserAPI);

describe("User Service", () => {
  let instance: UserService;
  // 仅需要在每个测试开始前清理调用记录即可，不会清除已经绑定的Mock实现
  beforeEach(() => {
    RestUserAPIMock.mockClear()
  });

  it("should get user name", () => {
    instance = new UserService();
    expect(instance.getName()).toBe(mockedUserName);
    expect(RestUserAPIMock).toHaveBeenCalledTimes(1);
  });
});

• 区分mockClear()和mockReset()的作用：mockReset()会彻底清除所有已经绑定的Mock实现，把Mock恢复到初始状态，如果使用了mockReset()，必须在调用后重新绑定所需的Mock实现。
• 遵守Jest的Mock工厂变量规则：在jest.mock的工厂函数中，仅能引用以mock开头的顶层变量，否则会触发Jest的变量作用域报错。
• 绑定Mock实现时，一定要将实现代码放在所有会修改Mock状态的钩子之后，避免时序错位导致的实现失效。

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