在Spring Boot微服务测试实践中，@MockBean和@SpyBean是开发者常用的Mockito注解，用于隔离外部依赖、验证交互行为。然而，近期在技术社区中浮现出一个隐蔽的“陷阱”——当开发者从@MockBean迁移到@SpyBean时，原本正常工作的doThrow()应答链会突然断裂，导致测试用例报错或行为异常。这一问题已引发多位资深开发者的关注和讨论。

问题背景：为什么需要迁移？

@MockBean会创建一个完全模拟的对象，所有方法调用均返回默认值（如null、0、空集合），适合完全隔离外部服务。而@SpyBean则保留真实对象的部分行为，允许开发者“打桩”特定方法，同时让其他方法继续执行真实逻辑。在集成测试中，若需要验证某个Bean的真实逻辑并仅覆盖少量方法，@SpyBean往往更合适。

例如，一个支付服务类PaymentService内部调用了verifyOrder()和deductBalance()两个方法。使用@SpyBean可以只对deductBalance()进行模拟抛出异常，而保留verifyOrder()的真实行为，从而更贴近生产场景。

问题现象：应答链断裂

一位开发者在Stack Overflow上反映，当团队将测试代码中的@MockBean替换为@SpyBean后，原本用于连续异常抛出的doThrow()连锁调用失败。具体代码片段如下：

// 使用@MockBean时正常
@MockBean
private PaymentService paymentService;

@Test
void testPaymentFailure() {
    doThrow(new PaymentException("余额不足"))
        .doThrow(new PaymentException("重复支付"))
        .when(paymentService).deductBalance(any());

    // 第一次调用抛出第一次异常，第二次调用抛出第二次异常 ...
}

迁移为@SpyBean后：

@SpyBean
private PaymentService paymentService;

同样的doThrow().doThrow()链式调用仅在第一次抛出异常，第二次及后续调用返回真实方法的返回值（或抛出真实异常），导致测试断言失败。

原因分析：Spy行为模式的根本差异

经Mockito官方文档和源码分析，问题根源在于@SpyBean与@MockBean的内部实现机制不同。

  • @MockBean：完全替代理真实对象，所有方法调用都经过Mockito的拦截器。当设置doThrow().doThrow()应答链时，Mockito会维护一个调用计数器，依次从链中取出对应的应答行为。链中元素用完前，每次都返回预设的异常。

  • @SpyBean：Spy对象本质上是真实对象的一个包装，未被桩化的方法调用会直接委托给真实对象。当使用doThrow().doThrow()打桩时，Mockito会创建一个Stubbing记录在Spy的拦截器中。然而，关键问题在于：Spy对象对同一个方法的连续打桩行为，第二次及以后的“doThrow”实际上并没有正确覆盖前一次的打桩。

更具体地说，在Mockito 2.x/3.x中，对Spy对象多次调用doThrow()（或doReturn()等）时，Mockito会错误地将后续的doThrow()视为对整个when()的重新配置，而不是追加到应答链末尾。这导致第一次doThrow()生效后，第二次doThrow()被解释为完全替换了之前的打桩，而替换后的打桩仅包含一个异常。因此，第二次调用时，Mockito认为打桩已经耗尽，转而调用真实方法。

解决方案

针对此问题，社区提供了两种已验证的解决方法：

方法一：使用willThrow()结合Answer链

使用Mockito的willAnswer()或willThrow()（来自BDDMockito）配合自定义Answer实现链式抛出异常：

import static org.mockito.BDDMockito.*;

given(paymentService.deductBalance(any()))
    .willThrow(new PaymentException("余额不足"))
    .willThrow(new PaymentException("重复支付"));

given().willThrow().willThrow()在Spy对象上表现正常，因为BDD风格的方法内部处理了Stubbing的追加逻辑。

方法二：回退到@MockBean并配合Answer模拟真实逻辑

如果必须保留测试中原有的链式调用，且无法使用BDD风格，则建议放弃@SpyBean，改用@MockBean并手动模拟需要真实逻辑的部分：

@MockBean
private PaymentService paymentService;

@BeforeEach
void setup() {
    // 对非关键方法模拟真实行为
    doCallRealMethod().when(paymentService).verifyOrder(any());
}

但此方法增加了维护成本，且可能破坏测试隔离性。

行业见解与最佳实践

Spring Boot测试专家、Mockito贡献者之一指出：“@SpyBean的设计初衷是用于对特定方法进行轻量级覆盖，而非用于复杂的连续桩行为。开发者应避免在Spy对象上使用多级doThrow().doThrow()，建议改用BDD风格或直接使用@MockBean配合@InjectMocks。”

此外，Mockito 4.x版本虽对Spy的桩行为进行了部分优化，但尚未完全解决此问题。因此，当前最佳实践是： - 如果测试需要验证连续多次调用不同异常，应使用@MockBean+自定义Answer（如new AnswersWithDelay()）或given().willThrow()链。 - 如果只需单次异常抛出，@SpyBean的doThrow()完全可用。

总结

从@MockBean迁移到@SpyBean看似简单，实则暗藏陷阱。doThrow()应答链断裂问题提醒我们：在面对不同的测试框架行为时，不能仅凭表面语法相似就贸然替换。开发者需要深入理解Mock与Spy在拦截器、Stubbing管理上的本质差异，并根据测试场景选择最合适的工具。建议团队在引入此类变更前，进行充分测试和代码审查，避免在生产环境中因测试疏漏导致缺陷逃逸。