Spring Data Redis集群连接节点获取问题解析

问题背景

在使用Spring Data Redis连接Redis集群时，开发者可能会遇到一个常见问题：通过clusterGetNodes()方法获取集群节点时，始终只能获取到一个节点，而实际上集群配置了多个节点。这种情况通常发生在Redis集群环境配置不完整的情况下。

问题现象

开发者配置了一个包含6个节点的Redis集群，通过Spring Boot的配置文件指定了所有节点地址：

spring.data.redis.cluster.nodes=127.0.0.1:16379,127.0.0.1:17379,127.0.0.1:18379,127.0.0.1:19379,127.0.0.1:20379,127.0.0.1:21379

但在代码中调用以下方法时：

redisTemplate.getConnectionFactory().getClusterConnection()
        .clusterGetNodes()
        .forEach(x -> System.out.println(x.getHost() + ":" + x.getPort()));

却只能获取到一个节点，而不是预期的6个节点。

问题原因

这个问题的主要原因是Redis集群配置中缺少了总线端口的正确设置。在Redis集群中，每个节点实际上使用两个端口：

1. 客户端通信端口（通常配置的端口）
2. 集群总线端口（客户端端口 + 10000）

总线端口用于节点间的内部通信，包括故障检测、配置更新、故障转移授权等。如果总线端口没有正确配置，客户端就无法获取完整的集群拓扑信息。

解决方案

解决这个问题的关键在于正确配置Redis集群的总线端口。具体方法如下：

1. 在Docker Compose配置中，确保每个Redis节点都暴露了两个端口：

   • 客户端端口（如16379）
   • 总线端口（16379 + 10000 = 26379）

2. 修改Redis节点的环境变量配置，确保集群总线通信能够正常工作。

配置示例

正确的Docker Compose配置应该类似这样：

services:
  redis-node-0:
    image: docker.io/bitnami/redis-cluster:7.2
    ports:
      - "16379:16379"
      - "26379:26379"  # 总线端口
    environment:
      REDIS_CLUSTER_ANNOUNCE_PORT: 16379
      REDIS_CLUSTER_ANNOUNCE_BUS_PORT: 26379
      # 其他配置...

技术原理

Redis集群使用两种不同的端口来实现其功能：

1. 客户端端口：用于处理客户端请求，执行数据读写操作。
2. 总线端口：专门用于集群内部通信，包括：
   • 节点发现
   • 故障检测
   • 配置传播
   • 故障转移协调

当客户端连接集群时，首先会连接配置的任意一个节点，然后通过该节点获取完整的集群拓扑。如果总线端口没有正确配置，客户端就无法获取完整的集群信息，导致只能看到一个节点。

最佳实践

1. 始终确保Redis集群节点配置了正确的总线端口（客户端端口+10000）。
2. 在容器化部署时，确保总线端口也被正确暴露和映射。
3. 在Spring Boot配置中，只需要配置客户端端口即可，Spring Data Redis会自动处理集群发现。
4. 定期检查集群健康状态，确保所有节点都能正常通信。

总结

Redis集群的正确配置对于保证应用程序的高可用性至关重要。总线端口的正确配置是确保集群节点间正常通信的基础。通过理解Redis集群的通信机制，开发者可以更好地诊断和解决类似的问题，确保应用程序能够充分利用Redis集群提供的分布式特性。