Spring Boot测试中Redis容器启动失败连接被拒问题排查

以下是针对Redis容器连接失败问题的具体排查和解决步骤：

1. 确认Redis容器的正确初始化与端口映射 #

Test Containers会为容器分配随机主机端口，而非固定的6379，直接用localhost:6379必然连接失败。先确保正确初始化Redis容器并获取实际映射端口：

// 在测试类中定义Redis容器实例
private static final RedisContainer REDIS_CONTAINER = new RedisContainer(DockerImageName.parse("redis:latest"));

// 静态代码块启动容器
static {
    REDIS_CONTAINER.start();
}

2. 检查@DynamicPropertySource的配置完整性 #

确保动态配置覆盖所有Spring Boot Redis客户端需要的参数，不要遗漏关键配置项：

@DynamicPropertySource
static void redisProperties(DynamicPropertyRegistry registry) {
    registry.add("spring.data.redis.host", REDIS_CONTAINER::getHost);
    registry.add("spring.data.redis.port", REDIS_CONTAINER::getFirstMappedPort);
    // 可选：配置连接超时，适配Lettuce等客户端
    registry.add("spring.data.redis.timeout", () -> "PT3S");
}

注意：如果项目使用spring.redis.*前缀而非spring.data.redis.*，要对应调整配置键名。

3. 确保测试类注解配置正确 #

测试类需添加@SpringBootTest，若使用JUnit 5，要引入Test Containers的@Testcontainers注解：

@SpringBootTest
@Testcontainers
class YourRedisIntegrationTest {
    // ... 测试代码
}

4. 处理Redis容器启动延迟问题 #

有时Redis容器显示启动但内部服务未就绪，可添加等待策略：

static {
    REDIS_CONTAINER.withStartupStrategy(StartupStrategy.WAIT_FOR_HEALTHCHECK)
                   .start();
}

或者手动等待端口就绪：

static {
    REDIS_CONTAINER.start();
    Wait.forListeningPort().waitUntilReady(REDIS_CONTAINER);
}

5. 排查静态配置覆盖动态属性 #

检查application-test.yml/application-test.properties中是否存在Redis静态配置，静态配置优先级可能高于动态配置，需注释或删除：

# application-test.yml 中移除或注释以下内容
# spring:
#   data:
#     redis:
#       host: localhost
#       port: 6379

6. 验证容器状态与日志 #

若以上步骤无效，打印Redis容器日志和状态，确认容器是否真的正常启动：

System.out.println("Redis容器日志：" + REDIS_CONTAINER.getLogs());
System.out.println("Redis容器主机：" + REDIS_CONTAINER.getHost());
System.out.println("Redis映射端口：" + REDIS_CONTAINER.getFirstMappedPort());

通过日志可排查容器内部启动错误，比如镜像拉取失败、配置异常等。

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