Redis宕机后Spring微服务请求超时2分钟问题求助

问题原因分析 #

1. spring.redis.timeout配置的作用误解 #

你配置的spring.redis.timeout=5000对应的是Lettuce的命令执行超时，仅当Redis服务正常但命令执行耗时过长时生效。当Redis宕机导致连接无法建立时，这个配置不会限制连接重试的总时间。

2. Lettuce默认的重连重试策略过于宽松 #

Lettuce客户端默认采用指数退避重试策略，默认配置下会进行多次重试，每次重试的间隔时间递增（比如初始间隔100ms，之后每次翻倍，最大间隔10s），且默认的重试次数上限较高，多次重试的总时间累积后接近2分钟，这就是每个请求需要等待这么久的核心原因。

3. 未配置连接超时时间 #

默认情况下，Lettuce的Socket连接超时没有明确限制，单次连接尝试的耗时可能较长，再加上多次重试，进一步拉长了总等待时间。

解决方案 #

需要自定义Lettuce的客户端配置，限制连接超时和重试策略，避免无限制的重连等待。修改你的LettuceConnectionFactory配置如下：

@Bean
public LettuceConnectionFactory connectionFactory() {
    RedisProperties properties = properties();
    RedisStandaloneConfiguration configuration = new RedisStandaloneConfiguration();
    configuration.setHostName(properties.getHost());
    configuration.setPort(properties.getPort());

    // 配置Lettuce客户端选项
    ClientOptions clientOptions = ClientOptions.builder()
            // 设置连接超时时间（单位：毫秒）
            .socketOptions(SocketOptions.builder().connectTimeout(Duration.ofMillis(5000)).build())
            // 配置重试策略：限制重试次数和间隔
            .retryOptions(RetryOptions.builder()
                    .maxAttempts(3) // 最大重试次数
                    .initialDelay(Duration.ofMillis(100)) // 初始重试间隔
                    .multiplier(2) // 间隔乘数
                    .maxDelay(Duration.ofMillis(1000)) // 最大重试间隔
                    .build())
            .build();

    LettuceConnectionFactory factory = new LettuceConnectionFactory(configuration);
    factory.setClientOptions(clientOptions);
    return factory;
}

@Bean
public RedisTemplate<String, Object> redisTemplate() {
    RedisTemplate<String, Object> template = new RedisTemplate<>();
    template.setConnectionFactory(connectionFactory());
    template.setKeySerializer(new JdkSerializationRedisSerializer());
    template.setValueSerializer(new GenericToStringSerializer<>(Object.class));
    return template;
}

关键配置说明 #

• connectTimeout：设置单次连接Redis的超时时间，避免单次连接尝试耗时过久。
• maxAttempts：限制最大重试次数，避免无限重试。
• maxDelay：设置重试的最大间隔时间，防止间隔过长导致总等待时间失控。

另外，还可以结合Spring的断路器（如Resilience4j）对Redis操作进行熔断，当Redis持续不可用时，直接返回降级结果，避免请求长时间阻塞。

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