链式调用doReturn返回实例顺序异常，测试用例偶现失败

根因分析 #

该偶发返回顺序反转问题是Mockito Stub配置的常见问题，核心触发原因通常为以下两类：

1. 重复Stub覆盖：你在测试上下文的其他位置（包括@Before前置方法、父类测试逻辑、同测试类其他用例）对mock.someMethod()做过额外的Stub定义。Mockito中对同一个类的同一个方法做多次Stub时，后执行的Stub配置会覆盖之前的配置，如果测试用例执行顺序、Stub执行时机不稳定，就会出现返回顺序偶发错乱的问题。
2. 低版本Mockito已知缺陷：3.2.0版本以下的Mockito存在链式doReturn调用的顺序解析Bug，在部分场景下会出现链式返回值顺序反转的问题。

修复方案 #

• 排查全测试上下文对mock.someMethod()的Stub配置，确保同一方法仅做一次Stub定义，避免重复配置互相覆盖。
• 改用更稳定的可变参数写法替代链式调用，逻辑完全等价但不存在链式顺序解析问题：

  doReturn(firstInstance, secondInstance).when(mock).someMethod();
  

• 若测试逻辑依赖方法调用顺序，可搭配InOrder显式校验调用时序，避免隐式依赖导致的用例不稳定：

  // 校验方法调用顺序符合预期
  InOrder inOrder = inOrder(mock);
  inOrder.verify(mock).someMethod();
  inOrder.verify(mock).someMethod();
  

• 升级Mockito到3.2.0以上的稳定版本，规避版本本身的已知缺陷。
• 若测试用例并发执行，确保Mock实例不会跨用例共享，避免不同用例的Stub配置互相污染。

内容的提问来源于stack exchange，提问作者Ayush Singh