Mockito中多次配置同一方法行为时的陷阱与正确用法

风杰同学_8721

风杰同学_8721

2026-11-21

834人浏览

原创

Mockito中多次配置同一方法行为时的陷阱与正确用法

在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 进行声明式配置,并通过拆分测试用例提升可维护性与可靠性。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

13097

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

10142

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8592

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1364

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1088

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1636

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3429

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20651

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1475

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习