
Mockito 无法模拟被 final 修饰的方法(包括含泛型参数的 void 方法),需移除 final 修饰符才能正常使用 doNothing() 等 stubbing 行为;非 final 的普通方法(如 error)则可直接模拟。
mockito 无法模拟被 `final` 修饰的方法(包括含泛型参数的 void 方法),需移除 `final` 修饰符才能正常使用 `donothing()` 等 stubbing 行为;非 final 的普通方法(如 `error`)则可直接模拟。
在使用 Mockito 进行单元测试时,一个常见误区是试图模拟(stub)被 final 修饰的方法——这在 Mockito(尤其是较新版本,默认使用 inline mock maker)中是明确不支持的行为。你遇到的异常:
You cannot use argument matchers outside of verification or stubbing. ... Following methods *cannot* be stubbed/verified: final/private/equals()/hashCode()
并非由泛型参数本身引起,而是因为 Service.success(...) 方法被声明为 public final void success(...) —— final 是根本原因。Mockito 在运行时通过字节码增强生成代理类来实现 mock,而 final 方法无法被子类重写,因此无法被拦截和替换。
✅ 正确做法:移除 final 修饰符
将原方法:
public final void success(
final String corId,
final T t,
final String otherId) throws Exception {
// ...
}修改为:
public void success(
final String corId,
final T t,
final String otherId) throws Exception {
// ...
}⚠️ 注意:final 参数(如 final String corId)是完全允许的,它只影响参数变量不可重新赋值,与方法可模拟性无关;真正阻碍 mock 的是方法本身的 final 修饰符。
✅ 修改后,你的测试即可正常通过:
@Test
public void shouldSuccessCallback() {
// ✅ 现在可以安全使用 any() 或类型化匹配器
doNothing().when(service).success(anyString(), any(), anyString());
// 或更严格的写法(推荐):
doNothing().when(service).success(anyString(), any(DataDTO.class), anyString());
// ✅ error 方法本就非 final,无需改动
doNothing().when(service).error(anyString(), any(ErrorData.class), anyString());
greenWork.getDataResponses();
// 可选:验证调用是否发生
verify(service).success("corId", any(DataDTO.class), "otherId");
}? 补充建议:
- 若因设计约束必须保留
final方法(如防止子类覆盖),应考虑重构:将核心逻辑提取至非 final 的 protected 方法,或采用依赖抽象(如接口)+ 非 final 实现的方式,提升可测性; - 使用
any()匹配泛型参数时,确保泛型擦除不会导致歧义(如any(List.class)优于any()当需明确类型时); - 始终优先使用
verify(...).method(...)验证行为,而非仅依赖doNothing(),以增强测试的确定性。
总之,final 方法与 Mockito 的本质机制冲突,移除 final 是解决该问题的必要且充分条件——泛型本身从来不是障碍。

















