@MockBean用于在Spring Test上下文中动态替换或添加Bean，将真实依赖（如RestTemplate、DAO）替换为Mockito Mock，实现测试隔离、快速稳定。它自动注册Mock到ApplicationContext，覆盖同类型Bean，支持按类型或名称精准替换，作用域限于当前测试类或方法。
在 Spring Boot 测试中，@MockBean 是专门用于在 Spring Test 上下文中**动态替换（或添加）Bean** 的注解，它能帮你把真实的服务（比如调用第三方 API 的 RestTemplate、WebClient 或数据库 DAO）替换成 Mockito Mock，从而彻底隔离外部网络依赖，让测试快速、稳定、可重复。
为什么 @MockBean 能替代真实 Bean？
@MockBean 不是普通 Mockito 的 @Mock，它会：
- 自动将生成的 Mock 对象注册进当前测试用的 Spring
ApplicationContext； - 如果容器中已有同类型的 Bean（比如你定义的
UserService），它会覆盖掉原来的 Bean； - 支持按类型（
@MockBean UserService）或按名称（@MockBean("userServiceImpl")）精准替换； - 作用域仅限当前测试类或测试方法（配合
@TestConfiguration可更细粒度控制）。
典型场景：替换 HTTP 客户端（RestTemplate / WebClient）
假设你有个服务类通过 RestTemplate 调用天气 API：
@Service
public class WeatherService {
private final RestTemplate restTemplate;
public WeatherService(RestTemplate restTemplate) {
this.restTemplate = restTemplate;
}
public String getWeather(String city) {
return restTemplate.getForObject(
"https://api.example.com/weather?city=" + city, String.class);
}
}
测试时用 @MockBean 替换 RestTemplate，并设定期望返回值：
@SpringBootTest
class WeatherServiceTest {
<pre class="brush:php;toolbar:false;">@Autowired
private WeatherService weatherService;
@MockBean
private RestTemplate restTemplate; // 自动替换容器中的 RestTemplate Bean
@Test
void shouldReturnMockedWeather() {
// 给 Mock 设置行为
when(restTemplate.getForObject(
anyString(), eq(String.class)))
.thenReturn("{\"temp\":25}");
String result = weatherService.getWeather("beijing");
assertThat(result).contains("25");
}}
这样测试不发真实 HTTP 请求，也不依赖网络或第三方服务可用性。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
替换自定义 Service Bean（更常见）
如果你的服务依赖另一个业务 Bean（如 PaymentService），直接 @MockBean 它即可：
@MockBean
private PaymentService paymentService;
<p>@Test
void shouldProcessOrderWithoutRealPayment() {
when(paymentService.charge(eq("123"), any(BigDecimal.class)))
.thenReturn(true);</p><pre class="brush:php;toolbar:false;">boolean success = orderService.placeOrder("123", BigDecimal.valueOf(99.9));
assertTrue(success);
verify(paymentService).charge("123", BigDecimal.valueOf(99.9));}
注意：@MockBean 替换的是 Spring 容器管理的 Bean，不是 new 出来的对象。确保被测代码是通过构造器/字段注入拿到该 Bean 的。
注意事项和常见陷阱
-
不要混用
@Mock和@MockBean：前者只创建 Mock 对象，但不会放进 Spring 上下文；后者才真正“接管”容器中的 Bean； -
@MockBean作用于测试类级别，所有@Test方法共享同一个 Mock 实例 —— 如需方法级隔离，可在每个测试里重置（reset(mock)）或使用@BeforeEach； - 若被替换 Bean 有多个实现，建议用
@Qualifier明确指定名称，或用@MockBean(name = "xxx")； - 搭配
@TestConfiguration可以在测试中定义轻量级配置类，只对当前测试生效，避免污染全局上下文。
不复杂但容易忽略：只要确保目标 Bean 是 Spring 管理的、且测试启用了 Spring 上下文（如 @SpringBootTest 或 @ContextConfiguration），@MockBean 就能干净地切断外部依赖。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
