使用@RunWith(SpringRunner.class)与@WebMvcTest时控制器测试失败排查

错误原因 #

这个报错的核心是Spring测试框架找不到你的Spring Boot应用核心配置类——也就是带@SpringBootApplication或@SpringBootConfiguration的类。没有这个配置类，Spring没法初始化测试所需的上下文环境，自然跑不起来测试。

你遗漏的点 #

1. 缺少Spring Boot测试专属注解：测试类没有添加能触发Spring上下文加载的注解，框架不知道该怎么启动测试环境。
2. 包结构不匹配：如果你的主应用类（带@SpringBootApplication）在com.example.app，但测试类放在了com.example.test这类完全不相关的包下，Spring默认的包扫描机制找不到配置类，也会报这个错。

为什么需要@SpringBootTest或@ContextConfiguration #

• @SpringBootTest：这是Spring Boot为集成测试量身打造的注解，它会自动扫描当前测试类所在包及父包，找到@SpringBootConfiguration类，帮你完整启动整个Spring应用上下文。适合需要依赖真实Bean、数据库连接等完整环境的控制器测试场景。
• @ContextConfiguration：如果不想加载整个应用上下文（比如只想做轻量的控制器逻辑测试），可以用这个注解手动指定要加载的配置类/配置文件，告诉Spring该用哪些配置来初始化测试上下文，避免不必要的资源加载。

常见修正示例 #

方案1：用@SpringBootTest加载完整上下文

import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.beans.factory.annotation.Autowired;
import org.junit.jupiter.api.Test;

@SpringBootTest
@AutoConfigureMockMvc // 自动配置MockMvc，方便模拟HTTP请求测试控制器
public class BasketControllerTest {

    @Autowired
    private MockMvc mockMvc;

    @Test
    public void testAddItemToBasket() throws Exception {
        // 这里写你的测试逻辑，比如模拟POST请求调用接口
    }
}

方案2：用@ContextConfiguration指定配置类

如果只想加载特定配置，比如只关联主应用配置类：

import org.springframework.test.context.ContextConfiguration;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.setup.MockMvcBuilders;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;

// 直接指定你的主应用配置类（比如BasketApplication）
@ContextConfiguration(classes = BasketApplication.class)
public class BasketControllerTest {

    private MockMvc mockMvc;

    @BeforeEach
    public void setup() {
        // 手动初始化MockMvc，绑定要测试的控制器
        mockMvc = MockMvcBuilders.standaloneSetup(new BasketController()).build();
    }

    @Test
    public void testGetBasketDetails() throws Exception {
        // 测试逻辑
    }
}

额外提示：规范包结构

如果把测试类放在和主应用类相同的包（或其子包）下，Spring就能自动扫描到配置类，不用手动指定classes参数。比如主类在com.example.shop，测试类放在com.example.shop.controller下即可。

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