SpringBoot控制器单元测试中ValidateRequest依赖未Mock致空指针

问题场景 #

尝试为SpringBoot控制器编写单元测试，测试类代码如下：

@WebMvcTest(controllers = MyController.class)
@ExtendWith(SpringExtension.class)
public class MyControllerTest {

    @Autowired
    private MockMvc mvc;

    @MockBean
    private ValidateRequest validateRequest;

    @MockBean
    private MyService myService;

    @Test
    public void createitem_InvalidRequest() throws Exception {
        given(validateRequest.validate(any())).willThrow(new InvalidRequestException("Invalid request"));

        mvc.perform()
        // ... 测试逻辑省略
    }
}

MyController通过@Autowired注入ValidateRequest和MyService两个依赖，其中ValidateRequest定义如下：

@Component
public class ValidateRequest extends SomeBaseClass{
    // ... 业务逻辑省略
}

当前测试运行时，validateRequest始终为null，触发空指针异常（NPE）。环境信息：Java 1.8，SpringBoot 2.3.3，测试依赖配置如下：

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

问题原因与解决方案 #

1. 移除冗余的@ExtendWith(SpringExtension.class) #

在SpringBoot 2.x及以上版本中，@WebMvcTest注解已经默认集成了SpringExtension，无需额外添加该注解。重复声明可能干扰测试上下文的初始化流程，导致MockBean无法正常注入。

修改后的测试类头部：

@WebMvcTest(controllers = MyController.class)
public class MyControllerTest {
    // ... 原有代码保留
}

2. 解决JUnit依赖冲突 #

spring-boot-starter-test已经包含了JUnit 5（Jupiter）相关依赖，而单独引入的junit:junit是JUnit 4版本，两者混用会导致测试引擎加载异常，进而影响MockBean的创建。需要移除单独的JUnit 4依赖，只保留spring-boot-starter-test。

修改后的依赖配置：

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

3. 验证父类初始化逻辑 #

如果上述修改后问题仍存在，检查SomeBaseClass是否包含特殊的初始化逻辑（比如构造函数依赖、@PostConstruct方法等）。这些逻辑可能导致ValidateRequest的Mock实例无法正常创建，可以尝试通过@MockBean的name属性指定Bean名称：

@MockBean(name = "validateRequest")
private ValidateRequest validateRequest;

或者使用MockitoAnnotations.openMocks(this)手动初始化Mock（需在测试方法前执行）：

@BeforeEach
void setUp() {
    MockitoAnnotations.openMocks(this);
}

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