Spring Boot 连接云端 Redis 集群失败？问题根源与根治方案
当您在 Spring Boot 应用中尝试连接云端 Redis 集群时遭遇失败，请不要急于检查代码。绝大多数情况下，问题的根源在于网络拓扑——您的应用很可能被 NAT（网络地址转换）机制所阻碍。具体表现为，客户端能够成功获取集群节点列表，但当集群返回一个 MOVED 重定向指令时，给出的目标地址却是一个内网 IP（例如 10.0.1.5:6379）。这个地址对于部署在外部网络的 Spring Boot 应用而言是无法直接访问的，连接因此中断。
为什么 Spring Boot 会收到内网 IP 重定向？
这源于 Redis Cluster 的核心工作机制。集群节点在响应 ASK 或 MOVED 这类重定向命令时，其返回的地址取决于节点自身“认为”的对外服务地址。这个地址由 cluster-announce-ip 配置项决定。如果开发者未显式设置此参数，Redis 节点将自动探测并使用其绑定的网卡地址或 bind 指令指定的地址。在典型的云服务器环境（如 AWS EC2、阿里云 ECS、腾讯云 CVM）中，自动探测到的地址几乎总是内网 IP。
因此，Spring Boot 常用的 Lettuce 客户端在接收到这个内网地址后，会忠实地尝试建立连接，结果必然是网络不可达。其典型表现是抛出 RedisCommandTimeoutException 异常，或在日志中看到如下错误：
Unable to connect to 10.0.1.5:6379
这并非密码或端口配置错误，纯粹是网络层路由无法抵达目标所致。
理解以下几点至关重要：
cluster-announce-ip必须设置为公网可路由的地址，例如云服务器的弹性公网 IP，或一个能够正确解析至公网 IP 的域名。- 切勿指望通过
bind 0.0.0.0来解决此问题。该配置仅控制 Redis 服务监听哪些网络接口，完全不影响集群对外通告的地址。 - 若您的 Redis 集群运行在 Docker 或 Kubernetes 等容器环境中，情况将更为复杂，还需额外处理容器网络与宿主机网络间的端口映射关系。
如何正确配置 cluster-announce-ip？
解决方案非常明确，但要求对集群中的每一个节点进行统一配置。在每个 Redis 节点的 redis.conf 配置文件中，您必须显式添加以下三行配置（顺序无关，但三者缺一不可）：
cluster-announce-ip 120.79.100.22 # 请替换为该节点实际的公网 IP cluster-announce-port 6379 # 必须与 `port` 配置保持一致（除非做了特殊端口映射） cluster-announce-bus-port 16379 # 集群总线通信端口，通常为 `port + 10000`
修改保存后，需要重启对应的 Redis 节点以使配置生效（例如，先执行 redis-cli -p 6379 shutdown，再以 redis-server redis.conf 命令启动）。请务必对集群中的所有主节点和从节点逐一执行此操作。
配置过程中还需注意以下细节：
- 如果集群节点分布在不同的云服务商或跨 VPC（虚拟私有云），必须确保它们之间的 16379 端口（集群总线端口）能够互通，这是集群内部节点通信的基础。
- 绝对禁止使用
localhost或127.0.0.1作为通告 IP，Lettuce 客户端会按此地址进行连接，必然导致失败。 - 若使用域名，务必确保 Spring Boot 客户端所在环境的 DNS 能够正确解析该域名，并注意防范 DNS 缓存可能引发的连接问题。
Spring Boot 配置里哪些项关键？
在 Spring Boot 的 `application.yml` 或 `application.properties` 配置文件中，核心目标并非指定连接某个特定节点，而是确保 Lettuce 客户端能够正确处理集群的重定向逻辑。一个优化的配置示例如下：
spring:
data:
redis:
cluster:
nodes: 120.79.100.22:6379,120.79.100.23:6379,120.79.100.24:6379
max-redirects: 6
timeout: 3000
lettuce:
pool:
max-idle: 10
min-idle: 2
max-wait: 2000
以下是对关键配置项的深入解析：
nodes：此列表应填入您能够从公网直接访问的集群初始节点地址。这些地址必须是公网 IP 及开放端口，并且这些节点自身已按上述方法正确配置了cluster-announce-ip。max-redirects：此参数控制客户端最多跟随的重定向次数。一个实用的建议是将其设置为集群中主节点的数量（例如，3主3从集群设为3，6主6从集群设为6），以避免因重定向链条过长而被意外截断连接。- 关于密码认证：如果 Redis 集群启用了密码保护，无需在每个节点地址后单独配置密码。只需统一设置
spring.data.redis.password属性，Lettuce 客户端会自动将该密码应用于所有集群连接请求。
如何验证配置已生效并绕过了 NAT？
理论配置完成后，必须进行实战验证。最直接的方法是在部署 Spring Boot 应用的服务器上，使用 `redis-cli` 命令行工具进行手动测试。
首先连接至集群中的任意一个已配置节点，然后执行一个会触发跨槽位重定向的操作：
redis-cli -h 120.79.100.22 -p 6379 -a yourpass 120.79.100.22:6379> set user:1001 "hello" -> Redirected to slot [12345] located at 120.79.100.23:6379 OK
请密切关注第二行重定向信息中显示的目标地址。如果配置成功，此处显示的必须是一个您可以通过 `telnet` 命令测试连通的公网地址（例如 120.79.100.23:6379），而绝不能是 10.x.x.x 或 172.x.x.x 这类私有内网地址。
如果返回的仍是内网 IP，则说明对应节点的 cluster-announce-ip 配置未生效，或 Redis 服务未正确重新加载配置。如果返回的是公网 IP，并且您能通过 `telnet 120.79.100.23 6379` 命令成功建立连接，那么恭喜，您的 Spring Boot 应用大概率也能顺利连通集群了。
最后，必须警惕一个极易被忽视的“木桶效应”：即使集群中只有一个节点遗漏了 cluster-announce-ip 配置，也可能导致整个集群的拓扑信息变得混乱。 因为 Lettuce 客户端可能从任何一个节点获取集群拓扑图，一旦它从那个配置错误的节点拿到了包含内网地址的拓扑信息，后续的所有重定向请求都可能因此失败。因此，确保集群中每一个节点的配置都正确无误，是彻底解决问题的根本所在。
