在 java 单元测试中,使用 @spybean 注入 spy bean 的核心做法是:在测试类上添加 @springboottest 注解以启动 spring 上下文,然后在需要被部分 mock 的字段上直接标注 @spybean。spring boot test 会自动从容器中获取该 bean 的真实实例,并用 mockito 的 spy 机制将其包装,从而允许开发者对特定方法进行 stubbing(打桩),而其余方法仍执行真实逻辑。

@SpyBean 与 @MockBean 的区别是什么
@SpyBean 和 @MockBean 都用于替换 Spring 容器中的 Bean,但行为截然不同。@MockBean 会创建一个完全空的 Mockito Mock 对象,所有方法默认返回 null 或空集合,除非显式定义行为;而 @SpyBean 保留真实 Bean 的所有实现,仅允许覆盖选定的方法。若测试目标是验证某个依赖项是否被调用,且无需关心其内部逻辑,应使用 @MockBean;若需测试当前类的逻辑,同时希望依赖项保持真实行为(如数据库查询、外部 API 调用),则必须使用 @SpyBean。

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.mockito.SpyBean;
import static org.assertj.core.api.Assertions.assertThat;
import static org.mockito.Mockito.*;
@SpringBootTest
public class OrderServiceTest {
@Autowired
private OrderService orderService;
@SpyBean
private PaymentGateway paymentGateway;
@Test
public void testOrderCreationWithRealPayment() {
// 仅对特定方法打桩,其他方法走真实逻辑
doReturn("PAYMENT_SUCCESS").when(paymentGateway).processPayment(any());
String orderId = orderService.createOrder("user123", 100.0);
// 验证真实方法未被调用(因为被 stubbed)
verify(paymentGateway, never()).refundPayment(any());
// 验证 stubbed 方法被调用
verify(paymentGateway).processPayment(any());
assertThat(orderId).isNotNull();
}
}
如何确保 @SpyBean 不干扰其他测试用例
由于 @SpyBean 会修改 Spring 容器中的 Bean 实例,若不清理状态,可能导致后续测试用例出现意外行为。最佳实践是在每个测试方法结束后重置 Spy 的状态,或在测试类级别使用 @DirtiesContext 强制刷新上下文。更推荐的做法是结合 @BeforeEach 调用 Mockito.reset() 或使用 lenient() 避免严格匹配导致的失败。此外,应避免在 @SpyBean 上设置全局默认行为,以免污染其他测试。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.boot.test.mock.mockito.SpyBean;
import static org.mockito.Mockito.*;
@SpringBootTest
public class InventoryServiceTest {
@Autowired
private InventoryService inventoryService;
@SpyBean
private StockRepository stockRepository;
@BeforeEach
void setUp() {
// 每次测试前重置 Spy,防止状态残留
reset(stockRepository);
}
@Test
public void testStockUpdate() {
// 模拟真实查询,但控制更新结果
when(stockRepository.findById(1L)).thenReturn(new Stock(1L, "ItemA", 10));
doNothing().when(stockRepository).updateStock(any());
inventoryService.reduceStock(1L, 5);
verify(stockRepository).findById(1L);
verify(stockRepository).updateStock(any());
}
@Test
public void testStockNotFound() {
when(stockRepository.findById(999L)).thenReturn(null);
try {
inventoryService.reduceStock(999L, 1);
} catch (Exception e) {
// 预期异常,验证真实逻辑路径
}
verify(stockRepository).findById(999L);
}
}
当 @SpyBean 依赖的 Bean 不存在时会发生什么
如果目标 Bean 未在 Spring 容器中注册(例如未加 @Component 或未通过 @Bean 定义),@SpyBean 会尝试创建一个新的 Bean 并包装为 Spy。这通常会导致测试失败,因为无法找到原始实例进行包装。解决方法是确保该 Bean 已被正确声明,或使用 @MockBean 替代。若确实需要测试缺失依赖的场景,应使用 @MockBean 显式提供 Mock 实例,而非依赖自动装配。

















