非响应式Spring Boot应用：如何替换RedisReactiveHealthIndicator为RedisHealthIndicator？

问题原因 #

你的非响应式应用之所以会使用RedisReactiveHealthIndicator，大概率是依赖中引入了Reactive Redis相关组件（比如spring-boot-starter-data-redis-reactive），触发Spring Boot自动配置后，优先注册了响应式的健康检查器。

解决方法 #

方法1：移除Reactive Redis依赖（推荐，若无需响应式Redis功能） #

如果应用不需要Reactive Redis能力，直接从依赖中移除spring-boot-starter-data-redis-reactive：

• Maven：在pom.xml中删除对应依赖，或通过排除方式移除：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-redis</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-redis-reactive</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Gradle：在build.gradle中删除对应依赖，或配置排除：

implementation('org.springframework.boot:spring-boot-starter-data-redis') {
    exclude group: 'org.springframework.boot', module: 'spring-boot-starter-data-redis-reactive'
}

移除后，Spring Boot会自动使用非响应式的RedisHealthIndicator。

方法2：手动注册RedisHealthIndicator并禁用响应式版本 #

如果必须保留Reactive Redis依赖，可通过配置类手动指定使用非响应式健康检查器：

1. 排除响应式健康检查的自动配置类：
   在启动类上添加注解排除对应配置：

@SpringBootApplication
@EnableAutoConfiguration(exclude = RedisReactiveHealthContributorAutoConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

注：不同Spring Boot版本的自动配置类名称可能略有差异，旧版本可能是RedisReactiveHealthIndicatorAutoConfiguration，可根据实际依赖调整。

2. 手动注册RedisHealthIndicator Bean：
   创建配置类，注入RedisConnectionFactory并注册非响应式健康检查器：

import org.springframework.boot.actuate.health.HealthIndicator;
import org.springframework.boot.actuate.redis.RedisHealthIndicator;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.redis.connection.RedisConnectionFactory;

@Configuration
public class RedisHealthConfig {

    @Bean
    @Primary
    public HealthIndicator redisHealthIndicator(RedisConnectionFactory connectionFactory) {
        return new RedisHealthIndicator(connectionFactory);
    }
}

添加@Primary注解可确保该Bean优先被健康检查框架选用。

方法3：通过配置禁用响应式健康检查 #

在application.properties或application.yml中关闭Redis响应式健康检查：

management.health.redis.reactive.enabled=false

或YAML格式：

management:
  health:
    redis:
      reactive:
        enabled: false

此配置会关闭响应式健康检查器的自动注册，让Spring Boot fallback到非响应式的RedisHealthIndicator。

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