Java中利用异常链二次提炼Redis集群节点宕机错误，需捕获JedisConnectionException等原始异常，提取IP、槽位等上下文，封装为带cause的自定义异常，实现可追溯、可监控、可降级的故障处理。
Java中利用异常链对Redis集群节点宕机错误进行二次提炼，核心在于捕获原始异常（如 JedisConnectionException、RedisClusterException），提取关键上下文（如失败节点IP、槽位范围、重试次数），再封装为业务语义更清晰的自定义异常，并保留原始异常作为 cause，形成可追溯的异常链。
识别并捕获典型的集群节点故障异常
Redis集群在节点宕机时，Jedis 或 Lettuce 客户端通常抛出以下异常：
-
redis.clients.jedis.exceptions.JedisConnectionException：连接拒绝、超时，常含 “Connection refused” 或 “Timeout” 字样 -
redis.clients.jedis.exceptions.RedisClusterException：集群拓扑不可用、槽位映射失败，如 “No reachable node in cluster” -
org.springframework.data.redis.RedisSystemException（Spring Data Redis 场景）：底层异常被包装后抛出
建议统一在模板方法或拦截器中捕获这些顶层异常，避免分散处理。
从异常消息和堆栈中提取节点级上下文
原始异常往往包含关键线索，需主动解析而非仅记录日志：
立即学习“Java免费学习笔记（深入）”；
- 检查异常消息是否含 IP:port（如
"Could not get connection from pool for host 10.0.1.22:7001"） - 解析
RedisClusterException的 cause 链，定位具体失败的JedisConnectionException - 若使用 Jedis，可通过
JedisCluster.getConnectionFromSlot(slot)尝试获取连接，捕获异常时记录 slot 和对应节点 - 借助
Throwable.getStackTrace()检索特定类名（如"JedisClusterInfoCache"）辅助判断是否集群元数据刷新失败
构建带业务语义的异常链并保留原始上下文
定义自定义异常，将技术故障映射为业务可理解的问题：
public class RedisClusterNodeFailureException extends RuntimeException {
private final String failedNode;
private final Integer slot;
private final int retryCount;
public RedisClusterNodeFailureException(String message, String failedNode, Integer slot,
int retryCount, Throwable cause) {
super(message, cause); // 关键：传入原始异常作为 cause
this.failedNode = failedNode;
this.slot = slot;
this.retryCount = retryCount;
}
}
在调用处封装：
try {
return jedisCluster.get("user:1001");
} catch (JedisConnectionException e) {
String node = extractNodeFromMessage(e.getMessage());
throw new RedisClusterNodeFailureException(
String.format("Redis 集群节点 %s 不可用，影响槽位 %d，已重试 %d 次",
node, getSlotByKey("user:1001"), currentRetry),
node, getSlotByKey("user:1001"), currentRetry, e);
}
这样既保留完整堆栈，又让上层能通过 instanceof 区分节点故障与序列化/超时等其他问题。
配合重试与降级做异常链的分级响应
异常链的价值在可观测性与决策支持：
- 监控系统可按异常类型 +
failedNode字段聚合告警，快速定位宕机节点 - 熔断器（如 Sentinel）可根据
RedisClusterNodeFailureException的出现频次触发节点隔离 - 降级逻辑可检查 cause 是否为连接类异常，决定走本地缓存或空结果，而非盲目重试
- 日志打印时调用
exception.toString()自动输出整条链，无需手动遍历 cause
不复杂但容易忽略：务必确保所有中间封装都传递原始 Throwable，否则异常链断裂，根因丢失。
