Redis TestContainer未运行致Spring Boot集成测试连接拒绝排查

以下是针对你的场景的核心排查点：

1. 确认TestContainers Redis容器是否正常启动 #

• 测试类必须正确声明并管理Redis容器：

  @Container
  private static final RedisContainer redisContainer = new RedisContainer(DockerImageName.parse("redis:7-alpine"));
  

  用@Container注解会让JUnit 5自动在测试前启动容器，测试后销毁。如果手动管理容器，要在@BeforeAll中显式启动：

  @BeforeAll
  static void initContainer() {
      redisContainer.start();
  }
  

• 可以临时添加日志验证端口映射：

  System.out.println("Redis容器映射端口：" + redisContainer.getMappedPort(6379));
  

  如果无输出或端口为0，说明容器未启动。

2. 检查RedisTestConfig是否动态绑定容器端口 #

绝对不能硬编码6379端口，TestContainers会随机映射端口，配置类必须动态获取容器的实际端口和主机：

@TestConfiguration
public class RedisTestConfig {
    @Autowired
    private RedisContainer redisContainer;

    @Bean
    public RedisConnectionFactory redisConnectionFactory() {
        RedisStandaloneConfiguration config = new RedisStandaloneConfiguration();
        config.setHostName(redisContainer.getHost());
        config.setPort(redisContainer.getMappedPort(RedisContainer.DEFAULT_PORT));
        return new LettuceConnectionFactory(config);
    }

    @Bean
    public StringRedisTemplate stringRedisTemplate(RedisConnectionFactory factory) {
        return new StringRedisTemplate(factory);
    }
}

同时测试类要引入这个配置：

@SpringBootTest
@Import(RedisTestConfig.class)
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
public class RedisIntegrationTest {
    // 测试代码
}

3. 排除Spring Boot默认Redis自动配置 #

如果测试类没有排除自动配置，Spring Boot会尝试连接本地localhost:6379，导致连接拒绝。在测试类添加：

@SpringBootTest(exclude = {RedisAutoConfiguration.class, RedisRepositoriesAutoConfiguration.class})

4. 验证依赖完整性 #

确保测试依赖包含TestContainers Redis和JUnit 5整合包：
Maven依赖：

<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>redis</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.testcontainers</groupId>
    <artifactId>junit-jupiter</artifactId>
    <scope>test</scope>
</dependency>

Gradle依赖：

testImplementation 'org.testcontainers:redis'
testImplementation 'org.testcontainers:junit-jupiter'

5. 排查容器启动失败原因 #

如果仅看到镜像拉取日志，容器可能启动失败，添加日志查看容器输出：

@BeforeAll
static void initContainer() {
    redisContainer.start();
    System.out.println("Redis容器日志：" + redisContainer.getLogs());
}

常见失败原因：Docker资源不足、镜像版本不兼容（比如用了需要高版本Docker的Redis镜像）、本地防火墙拦截容器端口。

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