Spring Boot集成测试配置Redis容器遭遇连接失败问题

核心排查与修复步骤 #

1. 确保Spring Boot应用上下文被正确加载 #

你的抽象测试类BaseIT缺少@SpringBootTest注解，这会导致Spring无法以Boot应用的逻辑加载上下文，初始化器设置的属性可能无法被Redis自动配置类读取。

修正后的BaseIT：

@SpringBootTest
@ActiveProfiles("integration-test")
@ContextConfiguration(initializers = DatabaseContainersInitializer.class)
@AutoConfigureMockMvc
public abstract class BaseIT extends GeneralConstants {
    // ...
}

2. 提升测试容器属性的优先级 #

你尝试过用MapPropertySource添加属性，但要确保它被放到最高优先级，避免被配置文件中的默认值覆盖。修正初始化器的属性设置逻辑：

@Slf4j
public class DatabaseContainersInitializer implements ApplicationContextInitializer<ConfigurableApplicationContext> {

    @Override
    public void initialize(ConfigurableApplicationContext applicationContext) {
        // 推荐用RedisContainer（Testcontainers专用Redis容器，更简洁）
        RedisContainer redisContainer = new RedisContainer("public.ecr.aws/docker/library/redis:alpine3.19");
        redisContainer.start();

        ConfigurableEnvironment environment = applicationContext.getEnvironment();
        // 将测试容器属性添加到PropertySource链最前端，确保优先级最高
        environment.getPropertySources().addFirst(new MapPropertySource("testcontainers-redis",
                Map.of(
                        "spring.redis.host", redisContainer.getHost(),
                        "spring.redis.port", redisContainer.getMappedPort(RedisContainer.DEFAULT_PORT)
                )));

        log.info("Redis容器已启动: {}:{}", redisContainer.getHost(), redisContainer.getMappedPort(RedisContainer.DEFAULT_PORT));
    }
}

3. 清理集成测试配置文件 #

打开application-integration-test.properties/yml，确认没有硬编码spring.redis.host或spring.redis.port。如果存在这些配置，会直接覆盖初始化器设置的动态属性，删除即可。

4. 验证初始化器是否执行 #

运行测试时，检查日志是否有初始化器中打印的Redis容器已启动信息：

• 如果无输出，说明初始化器未被触发：检查子类是否覆盖了@ContextConfiguration注解（比如子类自己指定了initializers但未包含当前初始化器），默认inheritInitializers为true，若子类手动指定初始化器需合并父类配置。

5. 开启属性加载调试日志 #

在application-integration-test.properties中添加：

logging.level.org.springframework.core.env=DEBUG

运行测试后，查看日志中spring.redis.host和spring.redis.port的最终来源，确认是否来自testcontainers-redis这个PropertySource。

额外注意事项 #

如果项目中有自定义Redis配置类（比如手动创建RedisConnectionFactory），确保这些Bean是延迟初始化的（给配置类或Bean添加@Lazy注解），避免在初始化器设置属性之前就创建了连接工厂。

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