在 spring boot 的单元测试中,@mockbean 通过替换 spring 应用上下文(applicationcontext)中同类型的 bean 来实现注入。当你将 @mockbean 标注在测试类的字段上时,spring 会生成一个 mockito mock 对象,并自动将其注册到上下文中,从而在后续使用 @autowired 或构造器注入时,直接获取到这个 mock 实例。

@MockBean 如何替换原有的 Service Bean?
@MockBean 的核心机制是“替换”。如果 Spring 上下文中已经存在一个类型为 UserRepository 的 Bean,@MockBean 会销毁原有的真实 Bean,并用生成的 Mock 对象取而代之。这意味着在测试运行期间,所有依赖 UserRepository 的组件都会收到这个 Mock 实例,而不是数据库连接的真实实现。

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.MockBean;
import static org.mockito.Mockito.when;
@SpringBootTest
class UserServiceTest {
// 声明 Mock Bean,Spring 会自动替换容器中的 UserRepository
@MockBean
private UserRepository userRepository;
@Autowired
private UserService userService;
@Test
void testFindUser() {
// 配置 Mock 行为:当调用 findById(1L) 时返回特定用户
when(userRepository.findById(1L)).thenReturn(java.util.Optional.of(new User(1L, "Alice")));
// 执行逻辑
User user = userService.findUserById(1L);
// 验证结果
assert user.getName().equals("Alice");
}
}
上述代码展示了完整的测试结构。首先,@SpringBootTest 启动应用上下文。接着,@MockBean 确保 userRepository 字段被注入为 Mock 对象。在测试方法中,通过 when(...).thenReturn(...) 定义 Mock 的行为。最后,调用业务层 userService,其内部调用的 userRepository 实际上是我们在测试中配置的 Mock,因此不会触发真实的数据库查询。
如何验证 Mock Bean 的方法是否被正确调用?
除了配置返回值,通常还需要验证 Mock 方法是否按预期被调用,例如检查调用次数或参数。这可以通过 Mockito 提供的 verify() 静态方法实现。由于 @MockBean 注入的就是标准的 Mockito Mock 对象,因此可以直接对其使用 verify 来断言交互行为,确保业务逻辑符合预期。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

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.MockBean;
import static org.mockito.Mockito.*;
@SpringBootTest
class OrderServiceTest {
@MockBean
private PaymentGateway paymentGateway;
@Autowired
private OrderService orderService;
@Test
void testOrderCreationTriggersPayment() {
// 执行创建订单操作
orderService.createOrder(new Order(101));
// 验证 PaymentGateway 的 processPayment 方法被恰好调用一次
verify(paymentGateway, times(1)).processPayment(any());
// 验证没有被调用其他无关方法
verifyNoMoreInteractions(paymentGateway);
}
}
在这个例子中,OrderService 依赖于 PaymentGateway。通过 @MockBean 注入 Mock 后,我们执行了 createOrder 方法。随后,使用 verify(paymentGateway, times(1))... 断言支付网关的处理方法被调用了一次。如果业务逻辑中没有调用该方法,或者调用了多次,测试将会失败。这种验证方式确保了集成测试不仅关注最终状态,还关注组件间的协作流程。
当 Mock Bean 与真实 Bean 共存时如何处理依赖冲突?
在实际项目中,一个服务可能依赖多个外部组件。如果只 Mock 部分依赖而保留其他真实 Bean,需要确保这些真实 Bean 在测试环境中是可用的,或者它们本身不依赖更深层的资源。如果某个未被 Mock 的依赖在上下文中不存在,Spring 启动时会报错。此时,要么补充相应的 @MockBean,要么确保该 Bean 在测试配置中已正确定义。
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.MockBean;
import static org.mockito.Mockito.when;
@SpringBootTest
class ComplexServiceTest {
// Mock 第一个依赖
@MockBean
private EmailService emailService;
// Mock 第二个依赖
@MockBean
private NotificationService notificationService;
@Autowired
private ComplexService complexService;
@Test
void testComplexWorkflow() {
// 配置 EmailService 行为
when(emailService.send(anyString())).thenReturn(true);
// 执行复杂业务逻辑
complexService.notifyUser("user@example.com", "Alert");
// 验证两个 Mock 都被正确调用
verify(emailService).send("user@example.com");
verify(notificationService).log(any());
}
}
此示例展示了多依赖场景。测试类中同时使用了两个 @MockBean,分别对应 EmailService 和 NotificationService。这样,ComplexService 在运行时获得的这两个依赖都是 Mock 对象。开发者可以独立配置每个 Mock 的行为,互不干扰。这种模式允许在不启动完整基础设施(如邮件服务器、消息队列)的情况下,对核心业务逻辑进行全面的集成测试。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










