@WebMvcTest中@MockBean注入真实服务实例而非Mock的问题

针对你在Spring Boot 3.1.2中遇到的@MockBean无法替换ClienteService真实实例的问题，以下是具体排查和解决步骤：

1. 检查JUnit版本与注解一致性 #

移除JUnit4后，必须确保测试类完全切换到JUnit 5（Jupiter）：

• 替换旧的org.junit.Test注解为org.junit.jupiter.api.Test
• 确保依赖中彻底排除JUnit4，只保留JUnit5相关依赖：

Maven示例：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
    <exclusions>
        <exclusion>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
        </exclusion>
    </exclusions>
</dependency>

2. 限制@WebMvcTest的扫描范围 #

@WebMvcTest如果未明确指定目标控制器，可能会加载整个上下文的真实Bean。务必在注解中精准指定要测试的控制器：

@WebMvcTest(ClienteController.class) // 明确指定测试的控制器类
class ClienteControllerTest {
    // ... 测试代码
}

3. 排查ClienteService的Bean创建逻辑 #

如果ClienteService被其他配置类强制实例化，@MockBean可能无法覆盖真实实例：

• 检查ClienteService是否带有@Service注解，且没有被@Conditional等注解限制Bean创建
• 若存在手动注册ClienteService的@Bean方法，需通过@WebMvcTest的excludeFilters或exclude参数排除该配置类

4. 验证CircuitBreakerRegistry的影响 #

由于CircuitBreakerRegistry是真实实例，可能因ClienteService依赖它导致Spring优先创建真实Service实例：

• 尝试临时给CircuitBreakerRegistry添加@MockBean，验证是否能让ClienteService的Mock生效：

@MockBean
private CircuitBreakerRegistry circuitBreakerRegistry;

• 如果使用Resilience4j等熔断组件，可排除相关自动配置类，避免干扰测试上下文：

@WebMvcTest(
    controllers = ClienteController.class,
    excludeAutoConfiguration = Resilience4jAutoConfiguration.class
)

5. 确认测试类的Bean注入方式 #

确保测试类采用正确的注入方式：

@WebMvcTest(ClienteController.class)
class ClienteControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @MockBean
    private ClienteService clienteService;

    @Test
    void testGetCliente() throws Exception {
        // 配置Mock行为
        when(clienteService.getById(1L)).thenReturn(new Cliente(1L, "Test"));

        // 执行请求并验证响应
        mockMvc.perform(get("/clientes/1"))
                .andExpect(status().isOk())
                .andExpect(jsonPath("$.id").value(1L));
    }
}

内容的提问来源于stack exchange，提问作者Gonzalo Martinez