本文介绍如何在 Spring Boot 集成测试（尤其是基于 @SpringBootTest(webEnvironment = RANDOM_PORT) 的 Actuator 安全测试）中，避免因缺失真实数据库凭证而导致启动失败的问题——核心方案是引入 H2 内存数据库作为测试时的自动替代数据源。
本文介绍如何在 spring boot 集成测试（尤其是基于 `@springboottest(webenvironment = random_port)` 的 actuator 安全测试）中，避免因缺失真实数据库凭证而导致启动失败的问题——核心方案是引入 h2 内存数据库作为测试时的自动替代数据源。
在 Spring Boot 应用中，当测试类使用 @SpringBootTest(webEnvironment = RANDOM_PORT) 启动完整上下文时，Spring Boot 会尝试初始化所有 @Configuration Bean，包括 DataSource。若 application.yml 中配置了带占位符的数据库属性（如 ${db.username}），而测试环境未提供对应值（例如本地或 CI 环境无法访问 CredHub），应用上下文将因 Failed to configure a DataSource 而启动失败，导致 Actuator 接口测试、CORS 配置验证等根本无法执行。
根本解决思路：让测试环境“无感跳过”真实数据库依赖
Spring Boot 提供了优雅的条件化自动配置机制。只要确保测试 classpath 中存在 H2 驱动，并满足以下任一条件，Spring Boot 就会自动配置一个内存版 H2DataSource，从而绕过对 db.* 属性的解析需求：
✅ 自动生效前提（三者满足其一即可）：
- spring.datasource.url 未显式配置（即保持为空或完全不定义）；
- 或 spring.datasource.url 显式指向 H2（如 jdbc:h2:mem:testdb）；
- 或 spring.datasource.driver-class-name 为 H2 驱动（如 org.h2.Driver）且 classpath 存在 H2 JAR。
⚠️ 注意：你当前的 app.yml 中硬编码了 driver-class-name 和 url 模板（含 ${db.host}），这会强制 Spring Boot 尝试解析所有占位符——即使你只想跑 Actuator 测试，它仍会因 db.* 缺失而报错。因此需隔离测试专用配置。
✅ 推荐实践：声明式隔离 + H2 自动装配
-
添加 H2 依赖（仅测试范围）
在 build.gradle 中补充：testImplementation 'com.h2database:h2'
-
创建测试专用配置文件 src/test/resources/application-test.yml
spring: profiles: active: test datasource: url: jdbc:h2:mem:testdb;DB_CLOSE_DELAY=-1;DB_CLOSE_ON_EXIT=FALSE driver-class-name: org.h2.Driver username: sa password: h2: console: enabled: true # 可选：启用 H2 控制台便于调试 -
在测试类上激活 test Profile 并禁用真实数据源自动配置（可选但更健壮）
@ExtendWith(SpringExtension.class) @SpringBootTest(webEnvironment = RANDOM_PORT) @ActiveProfiles("test") // ← 关键：优先加载 application-test.yml @Import(ExceptionHandlerConfiguration.class) @AutoConfigureWebTestClient(timeout = "30000") // 可选：彻底排除 DataSource 自动配置（若仍有冲突） @ContextConfiguration(classes = {TestConfig.class}) class ActuatorsSecurityTest { // ... 测试方法保持不变 } -
（进阶）定义空配置类防止意外加载
若项目中存在自定义 DataSource @Configuration 类，可在测试包中添加：@TestConfiguration public class TestConfig { @Bean @Primary @Profile("test") public DataSource dataSource() { return new EmbeddedDatabaseBuilder() .setType(EmbeddedDatabaseType.H2) .setScriptEncoding("UTF-8") .addScript("schema.sql") // 可选：初始化表结构 .build(); } }
? 关键注意事项
- ❌ 不要试图在 @SpringBootTest 中通过 @MockBean DataSource 解决——这会导致 JdbcTemplate、JPA EntityManager 等下游 Bean 初始化失败，违背“完整上下文”测试初衷。
- ✅ H2 是轻量、零依赖、纯内存的方案，无需额外服务，完美适配 CI/CD（如 Jenkins）。
- ? Actuator 安全测试本身不依赖数据库业务逻辑，只需 Web 层和 Security 配置生效，H2 仅用于满足 Spring Boot 的 DataSource 基础约束。
- ? 验证是否生效：运行测试时观察日志，应出现 HikariPool-1 - Starting... 和 H2 console available at /h2-console（若启用），而非 Could not resolve placeholder 'db.username'。
通过以上配置，你的 ActuatorsSecurityTest 将在无任何外部数据库凭证的情况下稳定启动，专注验证 /actuator/info、/actuator/env 等端点的 CORS 策略与安全拦截逻辑，真正实现“关注分离”与“可重复测试”。
