Spring Boot集成Redis Cluster报ERR This instance has cluster support disabled错误

核心报错原因 #

报错ERR This instance has cluster support disabled本质是客户端当前按单机模式和Redis交互，没有正确加载集群配置走集群逻辑，或是Redis侧本身没有正常启用集群模式。

逐一排查遗漏配置点 #

1. 代码分支逻辑校验 #

• 优先确认自定义配置clusterEnabled是否被正确赋值为true：
  大概率你代码里的if分支判断实际走了else的单机逻辑，常见问题是漏做Spring Boot配置映射，比如配置文件没有加对应开关，或是@Value/@ConfigurationProperties注入失败。可以在if分支内加一行日志log.info("集群模式已启用，节点列表：{}", redisNodesList)，启动后验证日志是否正常打印即可确认。
• 检查redisClusterNodes配置是否完整：Redis集群最少需要3个主节点，哪怕是测试用的伪集群也需要配置3个不同端口的节点，你当前只配置了127.0.0.1:6379单节点是无法构成合法集群的。

2. Redis集群侧状态校验 #

• 跳过代码直接用客户端验证Redis集群状态：执行redis-cli cluster info，如果返回cluster_enabled:1才是真正启用了集群，如果返回0说明你启动Redis时没有加载修改后的配置文件，需要用redis-server /path/to/your/redis.conf命令启动，不能直接执行redis-server走默认配置。
• 确认集群已经完成初始化：仅给单个实例开启cluster-enabled yes还不够，需要执行集群初始化命令完成节点握手和槽位分配，示例命令redis-cli --cluster create 节点1IP:端口 节点2IP:端口 节点3IP:端口 --cluster-replicas 1，未完成初始化的节点无法处理集群客户端的请求。

3. 代码配置补全 #

• 你的集群配置遗漏了密码配置：如果Redis集群设置了密码，需要给RedisClusterConfiguration也添加密码配置，否则鉴权异常也可能触发相关报错，参考补充代码：

RedisClusterConfiguration redisClusterConfiguration = new RedisClusterConfiguration(redisNodesList);
// 补充集群密码配置
redisClusterConfiguration.setPassword(redisPassword);
// 如有连接池需求补充客户端配置
JedisClientConfiguration jedisClientConfiguration = JedisClientConfiguration.builder()
        .usePooling()
        .poolConfig(jedisPoolConfig())
        .build();
jedisConnectionFactory = new JedisConnectionFactory(redisClusterConfiguration, jedisClientConfiguration);

4. 依赖版本兼容修复 #

你当前的依赖组合存在兼容风险：Spring Data Redis 2.1.3.RELEASE要求最低适配Jedis 2.9.3版本，你当前用的Jedis 2.9.0版本过低，建议将Jedis版本升级到2.9.3避免版本不兼容导致的配置加载异常。

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