使用 @spybean 可以在 spring boot 测试中保留 bean 的真实行为,同时允许对特定方法进行桩化(stubbing)或验证调用。具体做法是在测试类上添加该注解并指定目标 bean,随后通过 mockito 的 doreturn() 或 donothing() 语法替换部分逻辑,这样既执行了真实代码路径,又控制了关键依赖的输出。

@SpyBean 与 @MockBean 在注入时的行为差异是什么
主要区别在于 @MockBean 会用一个完全空的模拟对象替换容器中的 Bean,而 @SpyBean 会创建一个包裹真实对象的代理,默认调用真实方法。如果希望测试不触发任何外部依赖但需要完整的业务逻辑链路,应选用 @SpyBean;若只需隔离依赖且无需执行真实代码,则用 @MockBean。

import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.mockito.SpyBean;
import org.junit.jupiter.api.Test;
import static org.mockito.Mockito.*;
@SpringBootTest
class OrderServiceTest {
@SpyBean
private PaymentGateway paymentGateway;
@Test
void testPartialMock() {
doReturn("SUCCESS").when(paymentGateway).process(any());
// 其他方法仍走真实实现
}
}
如何在不破坏原有逻辑的前提下验证 @SpyBean 的调用次数
可以通过 verify() 方法检查被桩化的方法是否被正确调用,或者检查未被桩化的真实方法是否按预期执行。由于 @SpyBean 保留了真实状态,验证结果能反映真实的交互过程,适合用于审计日志、缓存更新等副作用较多的场景。

import org.junit.jupiter.api.Test;
import static org.mockito.Mockito.*;
import static org.assertj.core.api.Assertions.assertThat;
@SpringBootTest
class AuditLogTest {
@SpyBean
private AuditLogger auditLogger;
@Test
void verifyCallCount() {
// 触发业务逻辑
service.processOrder();
// 验证真实方法被调用
verify(auditLogger, times(1)).log(anyString());
assertThat(auditLogger.getLastStatus()).isEqualTo("COMPLETED");
}
}
当 @SpyBean 桩化方法与真实方法参数不一致时会发生什么
如果桩化时使用的匹配器(如 any())与实际调用参数类型不符,Mockito 会抛出 InvalidUseOfMatchersException 或忽略桩化导致真实方法被执行。建议严格匹配参数类型,或使用 ArgumentCaptor 捕获实际传入的参数以进行断言。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











