Mockito测试中Mock对象注入与方法验证的常见陷阱与解决方案

Mockito测试中Mock对象注入与方法验证的常见陷阱主要包括verify失败、InvocationTargetException异常，以及Mock/Spy对象使用不当，解决方案需围绕依赖控制、对象初始化方式调整及正确区分Mock与Spy展开。以下是具体分析与应对策略：

一、verify失败：“Wanted but not invoked”错误

核心原因：被测对象（SUT）未实际调用预期方法，或调用对象与Mock对象不匹配。常见场景包括：
依赖未正确注入：SUT通过非Mock途径（如直接new或静态方法）获取依赖，导致调用未经过Mock对象。
Spy与Mock混淆：对部分Mock对象（Spy）的方法调用未触发预期行为，或未对Spy对象的方法进行桩化。
方法调用次数不匹配：verify时指定的调用次数与实际不符（如expected=1但实际未调用）。
解决方案：
确保依赖通过Mock注入：使用@InjectMocks自动注入Mock依赖，或手动通过构造函数/Setter方法传入。例如：@Mock private ThingParent mockParent;@Mock private ThingGrandParent mockGrandParent;@InjectMocks private Thing thingUnderTest; // 自动注入mockParent和mockGrandParent
正确使用Spy对象：若需部分Mock真实对象（如调用真实方法但修改部分行为），使用@Spy并显式桩化目标方法：@Spy private Thing spyThing = new Thing();@Beforepublic void setup() { Mockito.doReturn(mockParent).when(spyThing).fun(anyInt()); // 桩化Spy对象的方法}
验证方法调用细节：使用verify(mock, times(n))明确调用次数，或通过ArgumentCaptor捕获参数验证：ArgumentCaptor<Integer> sizeCaptor = ArgumentCaptor.forClass(Integer.class);verify(mockThing).fun(sizeCaptor.capture());assertEquals(expectedSize, sizeCaptor.getValue());

二、InvocationTargetException异常

核心原因：在when().thenReturn()桩化时，被Mock的方法内部抛出异常。常见于：
Mock对象未正确初始化：未调用MockitoAnnotations.initMocks(this)或未使用MockitoJUnitRunner。
Spy对象未处理真实方法异常：对Spy对象桩化时，未覆盖可能抛出异常的真实方法。
静态方法/final类Mock失败：未使用PowerMock扩展，导致无法Mock静态方法或final类。
解决方案：
正确初始化Mock：使用@RunWith(MockitoJUnitRunner.class)或手动初始化：@RunWith(MockitoJUnitRunner.class)public class ThingTest { ... }// 或手动初始化@Beforepublic void setup() { MockitoAnnotations.initMocks(this);}
处理Spy对象的真实方法异常：对Spy对象的方法桩化时，显式定义返回值或异常：Mockito.doReturn(mockParent).when(spyThing).fun(anyInt()); // 正常返回值Mockito.doThrow(new RuntimeException()).when(spyThing).realMethod(); // 模拟异常
结合PowerMock处理静态/final方法：若需Mock静态方法，使用@PrepareForTest和PowerMockito.mockStatic()：@PrepareForTest({StaticClass.class})@RunWith(PowerMockRunner.class)public class Test { @Before public void setup() { PowerMockito.mockStatic(StaticClass.class); when(StaticClass.staticMethod()).thenReturn("mocked"); }}

三、Mock与Spy对象的混淆使用

核心区别：
Mock对象：完全虚拟，所有方法默认返回空或默认值，需显式桩化。
Spy对象：包装真实对象，默认调用真实方法，仅对桩化方法返回指定值。
陷阱场景：
对Spy对象未桩化的方法调用真实逻辑，可能导致意外行为或异常。
误将Spy对象当作Mock使用，未覆盖关键方法导致测试失败。
解决方案：
明确使用场景：
需要完全隔离依赖时用@Mock。
需要部分真实逻辑（如算法）但修改部分行为时用@Spy。
显式桩化Spy对象方法：@Spy private List<String> spyList = new ArrayList<>();@Beforepublic void setup() { Mockito.doReturn(100).when(spyList).size(); // 覆盖size()方法}

四、最佳实践总结

通过规范依赖管理、正确使用Mock/Spy对象及验证方法，可显著提升Mockito测试的健壮性。

热门标签