Java 中 Redis 怎么配置哨兵（Sentinel）集群实现主从节点的自动故障转移（Failover）与高可用-java教程-PHP中文网

java应用通过jedissentinelpool或lettuce连接redis哨兵集群可自动感知主节点变化并完成故障转移，前提是正确部署哨兵集群、使用支持sentinel的客户端，并合理配置连接池与重试逻辑。

java 中 redis 怎么配置哨兵（sentinel）集群实现主从节点的自动故障转移（failover）与高可用

Java 中通过 Jedis 或 Lettuce 客户端连接 Redis 哨兵集群，就能自动感知主节点变化、完成故障转移，无需改代码。关键不在 Java 侧“配置哨兵”，而在于：正确部署哨兵集群 + 使用支持 Sentinel 的客户端 + 合理设置连接池与重试逻辑。

Java 应用本身不参与哨兵选举或故障判断，它只是消费者。所以第一步必须确保后端哨兵就绪：

至少启动 3 个哨兵进程（如端口 26379/26380/26381），运行在不同机器或容器中
每个 sentinel.conf 包含一致的监控配置，例如：
sentinel monitor mymaster 192.168.1.100 6379 2
sentinel auth-pass mymaster redis123
sentinel down-after-milliseconds mymaster 5000
主从复制已稳定运行（redis-cli -p 6379 info replication 显示 role:master，从节点显示 master_link_status:up）
哨兵日志中能看到 +monitor 和 +sentinel，说明彼此发现成功

使用 JedisSentinelPool，它会自动向哨兵查询当前主节点地址，并在故障转移后刷新连接。

分析ZIP压缩包或GitLab仓库中的Java Maven项目，确定二次开发范围、类数量、模块分布及生产相关指标。

下载

添加 Maven 依赖（推荐 4.x+，兼容 Redis 6/7）：

  redis.clients
  jedis
  4.4.3
初始化连接池（传入哨兵地址集合 + 主节点逻辑名）：
Set sentinels = new HashSet();
sentinels.add("192.168.1.101:26379");
sentinels.add("192.168.1.102:26380");
sentinels.add("192.168.1.103:26381");
JedisSentinelPool pool = new JedisSentinelPool("mymaster", sentinels);
每次操作都从池中获取连接，用完归还（自动处理重连与主节点变更）：
try (Jedis jedis = pool.getResource()) {
jedis.set("key", "value");
System.out.println(jedis.get("key"));
}

哨兵切换通常 10–30 秒，但客户端若不配合，仍可能报错或丢请求。需注意：

连接池要启用 testOnBorrow / testOnReturn：避免拿到失效连接（如原主已变从）
可设 poolConfig.setTestOnBorrow(true) 并配合理超时
设置合理的 timeout 和 retry：网络抖动或切换瞬间，Jedis 默认抛异常，建议外层加简单重试（如最多 2 次）
不要缓存主节点 IP：绝不能自己解析一次哨兵返回的地址就长期直连——这会让故障转移完全失效
若用 Lettuce（推荐 Spring Boot 场景），配置更简洁：
spring.redis.sentinel.master=mymaster
spring.redis.sentinel.nodes=192.168.1.101:26379,192.168.1.102:26380