Spring Boot @MockBeans 注解指南

1. 概述

本文将深入探讨 Spring Boot 中 @MockBeans 注解的使用方法。作为开发者，我们经常需要在测试中模拟依赖项，而 Spring 提供的注解能帮我们简单粗暴地解决这类问题。下面通过实际示例，说明如何高效使用这些注解进行单元测试。

2. 示例准备

先搭建一个票务验证场景作为演示基础：

public class TicketValidator {
    private CustomerRepository customerRepository;
    private TicketRepository ticketRepository;

    public boolean validate(Long customerId, String code) {
        customerRepository.findById(customerId)
          .orElseThrow(() -> new RuntimeException("Customer not found"));

        ticketRepository.findByCode(code)
          .orElseThrow(() -> new RuntimeException("Ticket with given code not found"));
        return true;
    }
}

这个 validate() 方法执行两项检查：

根据客户ID查询数据库
根据票码查询数据库

⚠️ 注意：方法会抛出异常当任一数据不存在。接下来我们将用 Spring 的测试注解模拟这两个仓库的依赖。

3. @MockBean 注解详解

Spring 框架提供了 @MockBean 注解来优雅地模拟测试依赖。它的核心机制是：

在 Spring 应用上下文中创建模拟 Bean
若存在同类型 Bean，则自动替换为模拟版本

使用场景

✅ 字段级别模拟：直接在测试字段上使用

class MockBeanTicketValidatorUnitTest {
    @MockBean
    private CustomerRepository customerRepository;

    @Autowired
    private TicketRepository ticketRepository;

    @Autowired
    private TicketValidator ticketValidator;

    @Test
    void givenUnknownCustomer_whenValidate_thenThrowException() {
        String code = UUID.randomUUID().toString();
        when(customerRepository.findById(any())).thenReturn(Optional.empty());

        assertThrows(RuntimeException.class, () -> ticketValidator.validate(1L, code));
    }
}

✅ 类级别重复注解：Java 8+ 支持重复注解

@MockBean(CustomerRepository.class)
@MockBean(TicketRepository.class)
@SpringBootTest(classes = Application.class)
class MockBeanTicketValidatorUnitTest {
    // 自动注入模拟对象
    @Autowired
    private CustomerRepository customerRepository;

    @Autowired
    private TicketRepository ticketRepository;

    @Autowired
    private TicketValidator ticketValidator;
}

踩坑提醒

❌ 不能在上下文刷新期间使用：@MockBean 无法在应用上下文初始化阶段模拟 Bean 行为。若需要上下文刷新时的控制，考虑使用 @TestConfiguration 等方案。

4. @MockBeans 注解详解

@MockBeans 本质是 @MockBean 的容器注解，核心价值在于：

集中管理多个模拟 Bean
提升测试代码可读性
方便跨测试类复用模拟配置

使用示例

@MockBeans({
    @MockBean(CustomerRepository.class),
    @MockBean(TicketRepository.class)
})
@SpringBootTest(classes = Application.class)
class MockBeansTicketValidatorUnitTest {
    // 自动注入模拟对象
    @Autowired
    private CustomerRepository customerRepository;

    @Autowired
    private TicketRepository ticketRepository;

    @Autowired
    private TicketValidator ticketValidator;
}

关键特性

功能等价性：与字段级 @MockBean 效果完全相同
组织优势：所有模拟声明集中在一处，避免类注解堆积
兼容性：Java 8+ 下与重复注解方案可互换

⚠️ 注意：即使使用 @MockBeans，仍需通过 @Autowired 注入模拟对象。这是 Spring 测试框架的标准操作模式。

5. 总结

通过本文我们掌握了 Spring Boot 测试中模拟依赖的两种核心方式：

场景	推荐方案	优势
单个模拟	`@MockBean`	简单直接
多个模拟	`@MockBeans`	集中管理，代码整洁

✅ 最佳实践：

优先使用 @MockBeans 管理多个模拟
保持测试类注解区域简洁
注意上下文刷新时的限制

完整示例代码已上传至 GitHub，欢迎参考实践。

Persistence

REST

Security