本文讲解如何通过构造函数注入 mock 对象，使被测类真正使用模拟依赖，从而避免“Wanted but not invoked”错误，实现对 handle() 等方法中内部调用（如 bean1.method1()）的精准隔离与验证。
本文讲解如何通过构造函数注入 mock 对象，使被测类真正使用模拟依赖，从而避免“wanted but not invoked”错误，实现对 `handle()` 等方法中内部调用（如 `bean1.method1()`）的精准隔离与验证。
在使用 Mockito 进行单元测试时，一个常见误区是：仅声明 @Mock Bean1 bean1，却未将其注入到被测对象（SUT）中。此时，ClassA 实例仍使用 Spring 自动注入的原始 Bean1（或为 null），导致 sut.handle(d) 实际调用的是真实（或未初始化的）bean1.method1()，而非你配置的 mock 行为——这就是 verify 失败的根本原因：“期望调用发生，但实际未触发”。
要解决此问题，关键在于控制依赖的实例来源。推荐采用构造函数注入（Constructor Injection），既符合 Spring 最佳实践，又天然支持测试友好性。修改 ClassA 如下：
public class ClassA {
private final Bean1 bean1; // 使用 final 显式声明不可变依赖
// 供 Spring 容器使用的无参构造（保留 @Autowired）
public ClassA() {
this.bean1 = null; // 实际由 Spring 注入，测试中不使用
}
// 专为测试设计的构造函数（显式传入依赖）
public ClassA(Bean1 bean1) {
this.bean1 = Objects.requireNonNull(bean1, "bean1 must not be null");
}
public ClassC handle(ClassD d) {
ClassC c = bean1.method1(d); // 此处调用的是传入的 mock 实例
return methodA(c);
}
// 假设 methodA 是私有/包级方法，无需 mock；若需隔离，可考虑提取为可注入策略
private ClassC methodA(ClassC input) {
// ... 实现逻辑
return input;
}
}
对应测试代码应主动传入 mock 实例，并确保行为定义与验证一致：
@ExtendWith(MockitoExtension.class)
class ClassATest {
@Mock
ClassD d;
@Mock
Bean1 bean1;
@Mock
ClassC c;
private ClassA sut;
@BeforeEach
void setUp() {
sut = new ClassA(bean1); // ✅ 关键：将 mock 传入构造函数
}
@Test
void handleTest() {
// 配置 mock 行为：当 method1 被任意 ClassD 参数调用时，返回预设的 c
when(bean1.method1(any(ClassD.class))).thenReturn(c);
// 执行被测方法
ClassC result = sut.handle(d);
// 验证：method1 是否被调用一次，且参数为任意 ClassD 实例
verify(bean1, times(1)).method1(any(ClassD.class));
// 可选：验证返回值是否符合预期（如是否为同一引用或满足业务逻辑）
assertThat(result).isSameAs(c);
}
}
注意事项与最佳实践：
- ✅ 优先使用构造函数注入：比 @Autowired 字段注入更易测试、更安全（避免 null 依赖）、更利于静态分析；Spring Boot 4.3+ 默认支持构造函数注入自动装配。
- ⚠️ 避免 lenient().when(...)：它会掩盖未匹配的 stub 调用，掩盖真实问题；应使用 when(...).thenReturn(...) 并确保参数匹配（如用 any() 或精确匹配）。
- ? 若 methodA() 逻辑复杂且影响 handle() 行为，应将其提取为独立可测试组件（如策略接口），而非在 ClassA 内部硬编码。
- ? 若无法修改 ClassA 构造函数（如遗留代码），可考虑 ReflectionTestUtils.setField(sut, "bean1", bean1)，但这是侵入性方案，应作为最后手段。
通过构造函数显式传递 mock，你完全掌控了被测对象的依赖图谱，让单元测试真正成为“隔离的契约验证”，而非对集成行为的模糊猜测。
