Redis集群JedisNoReachableClusterNodeException问题排查与解决

2026-06-09 约 1863 字预计阅读 4 分钟

一、问题现象

在生产环境中，Java应用使用Jedis连接Redis集群时出现以下异常：

    redis.clients.jedis.exceptions.JedisNoReachableClusterNodeException: No reachable node in cluster

应用无法连接到Redis集群，导致会话管理、缓存等功能失效。

二、环境信息

Redis集群 ：6个节点（3主3从），部署在同一台服务器上
Jedis版本 ：2.x（不支持--cluster命令）
Java框架 ：Spring + Shiro
部署方式 ：Redis和应用在同一台服务器

三、问题排查过程

3.1 检查Redis进程状态

    ps aux | grep redis-server

输出显示所有6个Redis进程都在运行，说明进程正常。

3.2 检查集群节点状态

    redis-cli -h 172.17.140.201 -p 7000 cluster nodes

发现部分节点（如7000、7001、7002）显示的是127.0.0.1，而其他节点显示的是真实IP172.17.140.201，存在IP地址不一致 的问题。

3.3 检查Java应用配置

查看Spring配置文件：

    <bean id="jedisCluster" class="redis.clients.jedis.JedisCluster">
        <constructor-arg index="0" type="java.util.Set">
            <set>
                <bean class="redis.clients.jedis.HostAndPort">
                    <constructor-arg name="host" value="${redis.cluster.0.host}"/>
                    <constructor-arg name="port" value="${redis.cluster.0.port}"/>
                </bean>
                <!-- 其他节点配置... -->
            </set>
        </constructor-arg>
    </bean>

对应的properties配置：

    redis.cluster.0.host=127.0.0.1
    redis.cluster.0.port=7000
    # 所有节点都配置为127.0.0.1

3.4 网络连通性测试

    telnet 172.17.140.201 7000

结果：连接成功，说明网络是通的。

3.5 根本原因分析

问题出在IP地址不匹配 ：

Redis集群内部 ：部分节点的bind配置为172.17.140.201，导致集群内部记录的IP是真实IP
Java应用配置 ：Jedis配置使用的是127.0.0.1
结果：Jedis客户端尝试连接127.0.0.1，但Redis节点宣告的是172.17.140.201，导致连接失败

四、解决方案

4.1 方案选择

有两种解决方案：

方案A ：修改Redis集群配置，统一使用127.0.0.1（适合应用和Redis在同一台服务器）
方案B ：修改Java应用配置，统一使用真实IP172.17.140.201

本文采用方案A ，因为应用和Redis在同一台服务器上。

4.2 具体实施步骤

步骤1：修改Redis配置文件

将所有节点的bind配置统一改为127.0.0.1：

    cd ~/redis_cluster
    
    # 修改每个节点的bind配置
    for port in 7000 7001 7002 7003 7004 7005; do
      sed -i '/^bind/d' $port/redis.conf
      echo "bind 127.0.0.1" >> $port/redis.conf
    done
    
    # 验证修改结果
    grep "^bind" */redis.conf

步骤2：停止所有Redis节点

    killall redis-server

步骤3：清理旧数据

    cd ~/redis_cluster
    rm -f nodes-*.conf *.rdb

步骤4：启动所有节点

    for port in 7000 7001 7002 7003 7004 7005; do
      redis-server $port/redis.conf
    done

步骤5：重新创建集群

由于Redis版本较旧（不支持--cluster命令），使用redis-trib.rb创建：

    redis-trib.rb create --replicas 1 \
0.0.1:7000 \
0.0.1:7001 \
0.0.1:7002 \
0.0.1:7003 \
0.0.1:7004 \
0.0.1:7005

输入yes确认配置。

步骤6：验证集群状态

    # 查看集群节点
    redis-cli -h 127.0.0.1 -p 7000 cluster nodes
    
    # 测试读写
    redis-cli -h 127.0.0.1 -p 7000 set test "hello"
    redis-cli -h 127.0.0.1 -p 7000 get test

步骤7：重启Java应用

    # Tomcat
    ./shutdown.sh && ./startup.sh
    
    # Spring Boot
    java -jar your-app.jar

五、注意事项

5.1 关于CLUSTER MEET命令

在排查过程中，曾使用CLUSTER MEET命令手动将节点加入集群：

    redis-cli -h 172.17.140.201 -p 7000 CLUSTER MEET 172.17.140.201 7000

这个命令可以临时解决问题，但重启后配置会丢失，还是需要修改配置文件。

5.2 关于cluster-announce-ip指令

在旧版Redis（<4.0）中，不支持cluster-announce-ip指令，只能通过bind配置来设置IP地址。

    # 旧版Redis不支持
    cluster-announce-ip 172.17.140.201  # 会报错 Bad directive

5.3 关于MOVED错误

测试时可能会出现(error) MOVED 6918 127.0.0.1:7001，这是正常现象 ，表示key被路由到其他节点。JedisCluster会自动处理重定向，应用代码无需关心。

六、经验总结

6.1 核心要点

IP地址一致性 ：Redis集群内部宣告的IP必须与客户端连接的IP保持一致
版本兼容性 ：不同版本的Redis配置指令不同，需要注意版本差异
配置即代码 ：集群配置应纳入版本管理，避免手动修改

6.2 最佳实践

场景	推荐配置	原因
应用和Redis同机	Redis监听`127.0.0.1`	性能最好，无网络开销
应用和Redis异机	Redis监听`0.0.0.0`，配置真实IP	跨机通信必须使用真实IP
生产环境	使用配置文件统一管理	可复现、可追溯
Redis版本	升级到5.0+	支持`--cluster`命令和更多特性

6.3 快速排查清单

遇到JedisNoReachableClusterNodeException时，按以下顺序检查：

✅ Redis进程是否运行？
✅ 网络是否通畅？（telnet测试）
✅ Redis的bind配置是否正确？
✅ Jedis配置的IP是否与Redis宣告的IP一致？
✅ 防火墙是否开放了端口（包括集群总线端口+10000）？
✅ Jedis版本是否支持集群模式？

七、结语

本次问题的根本原因是Redis集群内部IP地址与客户端配置不一致。通过统一使用127.0.0.1，问题得到完全解决。

一句话总结 ：确保Redis集群所有节点的bind配置与Jedis客户端连接的IP地址保持一致，问题即可解决。

目录