本文介绍如何使用 Mockito 5.11+ 的 mockStatic 功能，配合 when(...).thenReturn(...) 正确模拟含默认方法的接口（如 UserService），并覆盖其通过静态工厂（getService()）返回实例后调用默认方法（getUserById）的行为。

本文介绍如何使用 mockito 5.11+ 的 `mockstatic` 功能，配合 `when(...).thenreturn(...)` 正确模拟含默认方法的接口（如 `userservice`），并覆盖其通过静态工厂（`getservice()`）返回实例后调用默认方法（`getuserbyid`）的行为。

在现代 Java（≥8）中，接口可定义 default 方法，但 Mockito 默认不支持直接对未实现类的接口实例（尤其是由静态工厂构造的对象）进行行为模拟——尤其当目标方法是 default 实现、且调用链为 UserService.getService().getUserById(...) 时，传统 @Mock 或 mock(UserService.class) 无法生效，因为 getService() 返回的是真实（非 mock）实例。

✅ 正确解法：使用 Mockito 静态方法模拟（mockStatic）（需 Mockito ≥ 5.11.0，且启用 mockito-inline）

首先，确保 pom.xml 中已引入兼容版本：

<dependency><groupid>org.mockito</groupid><artifactid>mockito-core</artifactid><version>5.12.0</version><scope>test</scope></dependency><!-- 必须启用 inline agent 支持静态/构造/finall 类模拟 --><dependency><groupid>org.mockito</groupid><artifactid>mockito-inline</artifactid><version>5.12.0</version><scope>test</scope></dependency>

接着，在测试类中编写如下逻辑：

import org.junit.jupiter.api.Test;
import org.mockito.MockedStatic;
import static org.mockito.Mockito.*;

@Test
void testDoUserBusiness_withMockedDefaultMethod() {
    String userId = "123";
    User mockUser = new User("Alice", "alice@example.com");

    // 1. 模拟 UserService 类的静态行为
    try (MockedStatic<userservice> userServiceStatic = mockStatic(UserService.class)) {
        // 2. 先 mock getService() 返回一个可控的 UserService 实例
        UserService mockService = mock(UserService.class);
        userServiceStatic.when(UserService::getService).thenReturn(mockService);

        // 3. 对 mockService 的 default 方法 getUserById 进行 stub（关键！）
        // 注意：default 方法属于实例方法，必须在 mock 实例上 when(...).thenReturn(...)
        when(mockService.getUserById(userId)).thenReturn(mockUser);

        // 4. 执行被测逻辑
        DemoUser demo = new DemoUser();
        demo.doUserBusiness(userId); // 内部调用 UserService.getService().getUserById(userId)

        // ✅ 验证：mockService 的 getUserById 被调用一次
        verify(mockService).getUserById(userId);
    }
}</userservice>

⚠️ 重要注意事项：

• ❌ 错误写法（常见误区）：

  // 错误：UserService.getService().getUserById(...) 是运行时调用，不能直接在静态类上 when()
  mockStatic(UserService.class)
      .when(() -> UserService.getService().getUserById("123")) // 编译失败！
      .thenReturn(mockUser);

  mockStatic.when() 只接受静态方法引用（如 UserService::getService），不支持链式调用表达式。

• ✅ 正确分层：先 mock getService() → 得到 mock 实例 → 再 stub 该实例上的 default 方法。

• 若 UserService 使用了 Retrofit 等框架，实际 getService() 返回的是代理对象（非纯接口实现），建议将 UserService 抽象为可注入依赖（如通过构造器或 @InjectMocks），以规避静态耦合——这是更可持续的测试设计。

总结：模拟接口默认方法的核心在于“两级 Mock”——先用 mockStatic 控制静态工厂输出，再对返回的 mock 接口实例调用 when(...).thenReturn(...) 去 stub 默认方法。这既符合 Mockito 最佳实践，也保持了测试的确定性与可维护性。