使用Docker Compose时SpringBoot无法连接Redis求助

针对你遇到的SpringBoot容器无法连接Redis容器、抛出RedisConnectionFailureException的问题，结合你提供的配置，以下是具体排查方向和解决方法：

核心排查点及解决方案 #

1. Redis服务未完全就绪时SpringBoot已启动 #

depends_on仅保证Redis容器先启动，但不保证Redis服务完成初始化。SpringBoot启动时尝试连接Redis，此时Redis可能还没准备好，导致连接失败。

解决方式：

• 添加健康检查依赖：修改Docker Compose配置，让SpringBoot容器等待Redis健康检查通过后再启动：
  更新docker-compose.yml：

  version: "3"
  services: 
    spring-boot-app:
      build:
        context: .
        dockerfile: Dockerfile
      image: imageone
      container_name: imageone_container
      networks:
        - my_network
      ports:
        - "9000:9000"
      depends_on:
        redis:
          condition: service_healthy # 等待Redis健康检查通过
      environment:      
        SPRING_REDIS_HOST: redis
        SPRING_REDIS_PORT: 6379
    redis:
      image: redis
      container_name: redis_container
      networks:
        - my_network
      ports:
        - "6379:6379"
      healthcheck:
        test: ["CMD", "redis-cli", "ping"] # 用redis-cli ping检查健康状态
        interval: 2s
        timeout: 3s
        retries: 5
  networks:
    my_network:
      driver: bridge
  

• SpringBoot内部重试连接：在项目中添加启动时重试Redis连接的逻辑，确保服务就绪后再进行操作：

  @Component
  public class RedisConnectionChecker implements ApplicationListener<ApplicationReadyEvent> {
      @Autowired
      private RedisConnectionFactory connectionFactory;
  
      @Override
      public void onApplicationEvent(ApplicationReadyEvent event) {
          int maxRetries = 10;
          long delayMs = 2000;
          for (int i = 1; i <= maxRetries; i++) {
              try (RedisConnection conn = connectionFactory.getConnection()) {
                  System.out.println("Redis连接成功");
                  return;
              } catch (RedisConnectionFailureException e) {
                  System.out.printf("Redis未就绪，重试第%d次%n", i);
                  try {
                      Thread.sleep(delayMs);
                  } catch (InterruptedException ie) {
                      Thread.currentThread().interrupt();
                  }
              }
          }
          throw new IllegalStateException("无法连接Redis，重试次数已耗尽");
      }
  }
  

2. Redis默认绑定本地地址，拒绝外部连接 #

默认Redis镜像的配置中，bind参数为127.0.0.1，仅允许本地连接，导致SpringBoot容器无法访问。

解决方式：
修改Redis服务的启动命令，允许所有IP连接：

redis:
  image: redis
  container_name: redis_container
  networks:
    - my_network
  ports:
    - "6379:6379"
  command: redis-server --bind 0.0.0.0 # 允许所有地址连接

3. RedisTemplate未正确初始化 #

如果RedisTemplate没有被正确配置，也可能引发连接相关问题。确保配置正确的序列化和连接工厂：

@Configuration
public class RedisConfig {
    @Bean
    public RedisTemplate<String, Object> redisTemplate(RedisConnectionFactory connectionFactory) {
        RedisTemplate<String, Object> template = new RedisTemplate<>();
        template.setConnectionFactory(connectionFactory);
        // 设置序列化器，避免键值乱码
        template.setKeySerializer(new StringRedisSerializer());
        template.setValueSerializer(new GenericJackson2JsonRedisSerializer());
        return template;
    }
}

验证步骤 #

1. 启动容器后，进入SpringBoot容器：

   docker exec -it imageone_container bash
   

2. 测试网络连通性：

   ping redis
   

   能ping通则网络配置正常。
3. 测试Redis连接：

   redis-cli -h redis -p 6379
   

   能进入Redis命令行则服务正常。

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