java中redis集群节点宕机时不会抛出redisclusternodedownexception，因该异常非jedis或lettuce官方api提供；实际抛出jedisconnectionexception、jedisclusterexception或redisconnectionexception等，需结合异常类型、消息关键词（如“connection refused”“clusterdown”）及上下文判断节点宕机。
Java 中 Redis 集群（Redis Cluster）在某个节点宕机时，并不会自动抛出 RedisClusterNodeDownException。因为这个异常类并不存在于主流 Redis 客户端（如 Lettuce 或 Jedis）的官方 API 中。
Redis 客户端实际抛出的异常类型
Lettuce（Spring Boot 默认推荐）和 Jedis 在遇到集群节点不可达、连接失败或槽位（slot）路由失败时，会抛出各自定义的运行时异常，而非一个叫 RedisClusterNodeDownException 的标准异常：
-
Lettuce：常见异常包括
RedisConnectionException（连接拒绝）、RedisCommandTimeoutException（超时）、RedisException（根异常），底层可能包装ChannelException或IOException；当槽映射过期且重试失败时，也可能抛RedisCommandExecutionException并带消息如"CLUSTERDOWN” 或"NOAUTH” 等。 -
Jedis：常用异常有
JedisConnectionException（节点连不上）、JedisClusterException（集群拓扑错误、槽不可达），其 message 可能包含"No node found for slot"或"IO error"。
如何识别“节点宕机”场景
不能依赖特定异常类名，而应结合异常类型 + 异常消息 + 上下文判断是否为节点宕机：
- 捕获
RedisConnectionException（Lettuce）或JedisConnectionException（Jedis），检查 cause 是否为java.net.ConnectException或java.net.SocketTimeoutException； - 检查异常 message 是否含
"Connection refused"、"Connection timed out"、"CLUSTERDOWN"、"NOADDR"等关键词； - 若执行命令后返回
MOVED或ASK重定向失败，或槽位无可用节点（No reachable node for slot），也表明部分节点不可用。
主动检测与容错建议
不要等异常发生才响应，可配合以下方式增强健壮性：
- 启用 Lettuce 的
ClusterTopologyRefreshOptions，设置自动刷新拓扑（如定时+失联后主动刷新）； - 配置合理的超时（
timeout、socketTimeout）和重试策略（如 Spring Data Redis 的RetryTemplate）； - 在业务层封装统一异常处理逻辑，对疑似节点宕机的异常做降级（如返回缓存旧值、调用备用服务）或告警；
- 通过
redis-cli -c -h host -p port cluster nodes或客户端 API（如 Lettuce 的StatefulRedisClusterConnection）定期探测节点健康状态。
自定义异常包装（按需）
若团队规范要求统一异常体系，可在拦截器或模板方法中封装判断逻辑，手动抛出自定义异常：
if (e instanceof RedisConnectionException && e.getMessage().contains("Connection refused")) {
throw new RedisClusterNodeDownException("Node " + targetHost + " is unreachable", e);
}
但注意：该类需自行定义，不属于 Redis 客户端 SDK，也不参与自动触发 —— 它是业务侧的语义包装，不是框架原生行为。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
