Spring MVC应用控制器单元测试Bean加载失败问题求助

核心问题拆解 #

用@WebMvcTest(ExpenseController.class)时，注释掉@Autowired控制器能正常加载，加回去就报找不到Bean，本质是控制器Bean没在测试上下文里被正确实例化，大概率和你的环境配置（Profile、条件注解、安全机制）有关。

逐个排查解决 #

1. 确认测试激活了正确的Profile #

如果你的ExpenseController或者它依赖的配置类带了@Profile注解，测试类必须激活对应环境：

@WebMvcTest(ExpenseController.class)
@ActiveProfiles("test") // 换成控制器生效的Profile，比如dev也可以，看实际配置
class ExpenseControllerTest {
    // ...
}

2. 给控制器依赖的服务类加MockBean #

@WebMvcTest只会加载控制器相关的Bean，不会自动加载服务、仓储这类依赖。如果控制器的构造函数依赖了ExpenseService这类Bean，必须手动Mock：

@WebMvcTest(ExpenseController.class)
@ActiveProfiles("test")
class ExpenseControllerTest {
    // 更推荐用MockMvc测试控制器，而非直接注入控制器实例
    @Autowired
    private MockMvc mockMvc;

    // Mock控制器依赖的服务类
    @MockBean
    private ExpenseService expenseService;

    // 测试示例
    @Test
    void testGetExpense() throws Exception {
        mockMvc.perform(get("/expenses/1"))
               .andExpect(status().isOk());
    }
}

3. 排除JWT安全配置的干扰 #

JWT的安全过滤器可能会影响上下文加载，导致控制器Bean注册失败，可以临时禁用测试里的安全过滤：

@WebMvcTest(ExpenseController.class)
@ActiveProfiles("test")
@AutoConfigureMockMvc(addFilters = false) // 关掉所有过滤器，包括JWT的
class ExpenseControllerTest {
    // ...
}

或者精准排除安全自动配置类：

@WebMvcTest(ExpenseController.class)
@ActiveProfiles("test")
@ImportAutoConfiguration(exclude = SecurityAutoConfiguration.class)
class ExpenseControllerTest {
    // ...
}

4. 检查控制器的条件注解 #

如果ExpenseController上有@ConditionalOnProperty，得确保测试配置文件（application-test.properties）里有对应的属性：
比如控制器上写了@ConditionalOnProperty(name = "expense.controller.enabled", havingValue = "true")，就在application-test.properties里加：

expense.controller.enabled=true

5. 分层测试的正确姿势 #

按你需求的分层测试方案，对应配置如下：

• 控制器层：用@WebMvcTest + @MockBean模拟服务层，专注测试请求映射、参数绑定逻辑
• 服务层：用@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.NONE) + @MockBean模拟仓储层，测试业务逻辑
• 仓储层：用@DataMongoTest + Testcontainers，测试数据访问：

@DataMongoTest
@ActiveProfiles("test")
@Testcontainers
class ExpenseRepositoryTest {
    @Container
    static MongoDBContainer mongoDBContainer = new MongoDBContainer("mongo:latest");

    @Autowired
    private ExpenseRepository expenseRepository;

    // 仓储测试方法...
}

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