运行SpringBootTest时如何访问H2 Console？

嘿，你遇到的问题其实挺常见的——默认情况下Spring Boot Test确实不会自动启动H2 Console，不过咱们有几种靠谱的办法能搞定它，先帮你分析下为啥你的配置没生效，再一步步解决：

为啥你的配置没起作用？ #

从你贴的自动配置报告来看，spring.h2.console.enabled=true没被识别，核心原因是测试环境的属性加载优先级：主目录（src/main/resources）的application.properties不一定会被测试上下文优先加载，或者测试专用的配置（如果有的话）覆盖了它；另外，Spring Boot Test在默认模式下，部分自动配置会被默认排除，也可能导致H2 Console的自动配置没触发。

解决方案1：用测试专用配置文件 #

最简单的办法是在src/test/resources下创建专属的application.properties，把H2 Console的配置写在这里：

# 开启H2控制台
spring.h2.console.enabled=true
# 设置控制台访问路径
spring.h2.console.path=/h2-console
# 配套的H2数据库配置（和你的测试用库保持一致）
spring.datasource.url=jdbc:h2:mem:testdb
spring.datasource.driver-class-name=org.h2.Driver
spring.datasource.username=sa
spring.datasource.password=

测试上下文会优先加载src/test/resources下的配置，这样H2ConsoleAutoConfiguration就能正确识别到enabled=true的属性，自动启动控制台了。

解决方案2：在测试类中直接指定属性 #

如果不想单独建配置文件，可以用@TestPropertySource直接在测试类上注入属性：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@TestPropertySource(properties = {
    "spring.h2.console.enabled=true",
    "spring.h2.console.path=/h2-console"
})
public class YourTestClass {
    // 你的测试代码
}

要是用的Spring Boot 2.2+，也可以用@DynamicPropertySource动态配置，灵活性更高：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class YourTestClass {

    @DynamicPropertySource
    static void h2ConsoleProperties(DynamicPropertyRegistry registry) {
        registry.add("spring.h2.console.enabled", () -> true);
        registry.add("spring.h2.console.path", () -> "/h2-console");
    }

    // 测试代码
}

解决方案3：手动注册H2 WebServlet #

如果自动配置还是没触发，那就手动注册H2的WebServlet，彻底绕开自动配置的限制：

@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class YourTestClass {

    @Bean
    public ServletRegistrationBean<WebServlet> h2ConsoleServlet() {
        ServletRegistrationBean<WebServlet> registrationBean = new ServletRegistrationBean<>(new WebServlet());
        // 指定控制台的访问路径
        registrationBean.addUrlMappings("/h2-console/*");
        return registrationBean;
    }

    // 测试代码
}

这样不管自动配置有没有生效，都会强制注册H2控制台的Servlet，保证能访问。

访问控制台的小提示 #

• 如果你用的是RANDOM_PORT（推荐，避免端口冲突），可以通过@LocalServerPort获取实际运行的端口：

@LocalServerPort
private int port;

// 控制台访问地址就是：http://localhost:" + port + "/h2-console

• 连接数据库时，JDBC URL要和你的测试用库完全一致（比如默认的jdbc:h2:mem:testdb），用户名填sa，密码留空就行。

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