本文介绍如何使用 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.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 最佳实践，也保持了测试的确定性与可维护性。
