Spring Boot MockMvc测试中缺失H2ConsoleProperties Bean问题排查

我有一个集成了MVC、Thymeleaf、Data JPA、H2的Spring Boot应用，已配置允许所有用户访问H2控制台：

@Bean
public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
    PathRequest.H2ConsoleRequestMatcher h2ConsoleRequestMatcher = PathRequest.toH2Console();
    http.authorizeHttpRequests(requests -> requests
            .requestMatchers("/").permitAll()
            .requestMatchers(h2ConsoleRequestMatcher).permitAll()
            .anyRequest().authenticated()
    );
    http.csrf(csrf -> csrf.ignoringRequestMatchers(h2ConsoleRequestMatcher));
    http.headers().frameOptions().sameOrigin();
    //...
    
    return http.build();
}

我编写了测试用例验证H2控制台的可访问性：

@SpringBootTest
@AutoConfigureMockMvc
class SecurityApplicationTests {

    @Autowired
    MockMvc mockMvc;

    @Test
    void shouldAccessH2Console() throws Exception {
        mockMvc.perform(get("/h2-console"))
                .andExpect(status().isOk());
    }
}

运行测试时出现NoSuchBeanDefinitionException：

No qualifying bean of type 'org.springframework.boot.autoconfigure.h2.H2ConsoleProperties' available

但启动主程序后可正常通过浏览器访问H2控制台。我认为@SpringBootTest应提供与@SpringBootApplication一致的完整应用上下文，请问为何测试中未创建H2ConsoleProperties Bean，该如何修复？

原因 #

Spring Boot的H2ConsoleAutoConfiguration（负责创建H2ConsoleProperties）默认仅在web应用环境下生效，而@SpringBootTest默认启动非web环境的上下文。另外，H2控制台自动配置依赖spring.h2.console.enabled=true配置，虽然主程序正常说明该配置已开启，但测试上下文可能因环境类型问题跳过了自动配置加载。

修复方式 #

有两种可行的修复方法：

1. 指定测试的web环境
   在@SpringBootTest注解中添加webEnvironment属性，强制启动web应用环境，触发H2控制台自动配置类加载：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@AutoConfigureMockMvc
class SecurityApplicationTests {
    // 原有测试代码保持不变
}

2. 手动导入H2控制台自动配置类
   若无需启动完整web环境，可在测试类上添加@Import(H2ConsoleAutoConfiguration.class)，手动引入自动配置类：

@SpringBootTest
@AutoConfigureMockMvc
@Import(H2ConsoleAutoConfiguration.class)
class SecurityApplicationTests {
    // 原有测试代码保持不变
}

同时要确保application.properties或application.yml中已配置spring.h2.console.enabled=true，保证测试上下文能读取到该配置，满足自动配置的触发条件。

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