
在Mockito中,连续调用when().thenReturn()或when().thenThrow()配置同一方法会导致前一次行为被触发,引发意外异常;应改用doThrow()/doReturn()系列API,或为不同场景拆分为独立测试用例。
在mockito中,连续调用when().thenreturn()或when().thenthrow()配置同一方法会导致前一次行为被触发,引发意外异常;应改用dothrow()/doreturn()系列api,或为不同场景拆分为独立测试用例。
当你在同一个测试方法中多次使用 when(...).thenXXX() 配置同一个 mock 方法(如 api.doApiCall())时,每次 when() 调用本身就会实际触发该 mock 方法的执行——而此时 Mockito 会按已注册的 stub 行为进行响应。这正是问题根源:
- 第一次
when(api.doApiCall(...)).thenReturn("200"):无前置行为,返回null(默认值),随后注册"200"响应; - 第二次
when(api.doApiCall(...)).thenThrow(...):此时会先执行 mock 方法,触发上一次注册的"200"返回值 → 但when()期望捕获的是 方法调用过程,而thenReturn("200")不抛异常,所以继续完成注册; - 第三次
when(...).thenThrow(...):再次调用api.doApiCall(...)→ 这次触发的是第二次注册的RuntimeException("400"),直接抛出异常,导致测试失败。
✅ 正确解法:使用 doThrow() / doReturn() 系列 API(即“void-returning stubbing”),它们绕过实际方法调用,直接绑定行为,避免副作用:
@Test
void testApiCall_Success() {
// ✅ 安全:doReturn 不触发实际调用
doReturn("200").when(api).doApiCall(any(Long.class), any(Integer.class));
assertEquals("nextpage.html", controller.save());
}
@Test
void testApiCall_BadRequest() {
// ✅ 安全:doThrow 不触发实际调用
doThrow(new RuntimeException("400")).when(api).doApiCall(any(Long.class), any(Integer.class));
assertEquals("error.html", controller.save());
}
@Test
void testApiCall_Unauthorized() {
// ✅ 同样安全,彼此完全隔离
doThrow(new RuntimeException("401")).when(api).doApiCall(any(Long.class), any(Integer.class));
assertEquals("error.html", controller.save());
}
? 关键区别对比:
| 写法 | 是否触发实际 mock 调用 | 适用场景 | 风险 |
|------|------------------------|----------|------|
| when(mock.method()).thenReturn(...) | ✅ 是(首次调用即执行) | 返回值非 void 的方法,且仅配置一次 | 多次配置时产生连锁副作用 |
| doReturn(...).when(mock).method() | ❌ 否(纯声明式绑定) | 所有场景,尤其需多次重置行为或 void 方法 | 无副作用,推荐用于复杂 stub 场景 |
⚠️ 注意事项:
-
doThrow()、doReturn()、doAnswer()等必须配合.when(mock).method()使用,语法固定; - 对于
void方法,只能使用doThrow()系列(因为when(voidMethod())在语法上不合法); - 单一测试方法中混合多种 stub 行为易导致状态污染,强烈建议遵循“一个测试验证一个行为”原则,将成功路径、400 错误、401 错误分别写成独立
@Test方法——不仅更清晰,也天然规避了 stub 冲突。
总结:不要在单个测试中反复覆盖同一方法的 stub 行为;优先使用 doXxx() 系列 API 进行声明式配置,并通过拆分测试用例提升可维护性与可靠性。










