最推荐方式是组合使用@SpringBootTest与@DynamicPropertySource，它专为动态注入设计，支持从Testcontainer等运行时来源取值，优先级高于application.yml且作用域限于当前测试类。
在 Spring Boot 集成测试中动态注入配置属性，核心目标是**不修改真实配置文件、不污染环境、可复用且精准控制**。最推荐、最灵活的方式是组合使用 @SpringBootTest + @DynamicPropertySource，它专为此类场景设计，比硬编码 properties 参数或改写 application.yml 更安全、更清晰。
用 @DynamicPropertySource 注入运行时值
这是 Spring Boot 2.2.5+ 提供的官方机制，允许你在测试类中以编程方式向 Spring 环境注册属性，优先级高于 application.yml，且只作用于当前测试类（或静态内部类）。
- 必须是
static方法，签名固定为void method(DynamicPropertyRegistry registry) - 支持从任意来源取值：本地变量、系统环境变量、Testcontainer 实例、随机端口、甚至加密密钥生成器
- 常用于替换数据库地址、Redis 连接、第三方 API 地址等敏感或环境强依赖项
示例：用 Testcontainer 启动 Redis 并注入其 host/port
@SpringBootTest
@Testcontainers
class RedisIntegrationTest {
@Container
static RedisContainer redis = new RedisContainer();
@DynamicPropertySource
static void redisProperties(DynamicPropertyRegistry registry) {
registry.add("spring.redis.host", redis::getHost);
registry.add("spring.redis.port", redis::getFirstMappedPort);
}
@Test
void shouldConnectToRedis() {
// 测试逻辑，此时 spring.redis.host 已被动态覆盖
}
}
用 @SpringBootTest(properties = ...) 快速覆盖简单值
适合临时覆盖单个或少量字符串型配置，语法简洁，无需额外方法声明。
- 属性格式为
"key=value"，支持多条，用数组传入 - 仅适用于字面量值（如端口、开关标志、测试数据库 URL），不适合复杂结构或需计算的值
- 无法引用其他变量或调用方法，灵活性有限
示例：
@SpringBootTest(
properties = {
"server.port=0", // 随机端口
"spring.datasource.url=jdbc:h2:mem:testdb",
"feature.toggle.enabled=true"
}
)
class FeatureToggleTest {
@Test
void shouldEnableFeatureWhenFlagTrue() {
// ...
}
}
用 @TestConfiguration 定义测试专用 Bean 替代配置逻辑
当需要“绕过”某个配置类（比如跳过生产用的 @ConditionalOnProperty 判断），或提供一个轻量替代实现时，@TestConfiguration 比直接改属性更彻底。
- 它本质是一个
@Configuration，但只在测试上下文中生效 - 可配合
@Bean覆盖原配置 Bean，或定义测试专用 Bean（如内存版数据源、模拟支付网关） - 与
@DynamicPropertySource协同使用效果更佳：前者管“行为”，后者管“参数”
示例：替换真实邮件服务为内存模拟器
@SpringBootTest
class EmailServiceTest {
@TestConfiguration
static class TestEmailConfig {
@Bean
@Primary
public JavaMailSender javaMailSender() {
return new MockJavaMailSender(); // 自定义模拟实现
}
}
@Autowired
private EmailService emailService;
@Test
void shouldSendEmailWithoutRealSMTP() {
emailService.send("test@example.com", "Hello");
// 验证发送是否被拦截/记录
}
}
避免踩坑：哪些方式不推荐
以下做法看似可行，但在团队协作或 CI/CD 中容易引发问题：
- 直接修改 src/test/resources/application.yml：多个测试共享同一文件，属性易冲突；不同环境分支难以维护
- 用 System.setProperty()：全局生效，可能影响其他并行测试；Spring Boot 的属性解析顺序复杂，不一定被识别
- 在 @BeforeAll 中手动调用 ConfigurableEnvironment：代码冗长、易出错，且破坏了 Spring Test 的声明式风格
真正可靠的动态注入，靠的是 Spring Boot 原生支持的声明式机制——@DynamicPropertySource 是首选，properties 属性是补充，@TestConfiguration 是进阶手段。三者按需组合，就能覆盖绝大多数集成测试中的配置定制需求。
