spring boot 全局异常处理可以通过自定义 @controlleradvice 拦截特定异常类来捕获热点 key 异常。具体做法是定义一个继承自 responseentityexceptionhandler 或实现 handlerexceptionresolver 的组件,在方法上使用 @exceptionhandler 注解并指定具体的异常类型(如 redis 客户端抛出的 cannotgetredisconnectionexception 或业务层定义的 hotkeyexception),从而将异常转换为统一的 json 响应。

@ControllerAdvice 如何配置以拦截 Redis 连接异常
通过注册一个全局异常处理器,可以统一接管所有 Controller 层的异常。针对热点 Key 导致的连接阻塞或超时,通常底层会抛出 CannotGetRedisConnectionException 或 JedisConnectionException。我们需要在 @ExceptionHandler 中明确指定这些异常类,确保它们被优先捕获。

import org.springframework.web.bind.annotation.*;
import org.springframework.http.ResponseEntity;
import redis.clients.jedis.exceptions.JedisConnectionException;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(JedisConnectionException.class)
public ResponseEntity<String> handleHotKeyException(JedisConnectionException ex) {
// 记录日志或进行降级逻辑
return ResponseEntity.status(503).body("Service Unavailable: Hot Key Detected");
}
}
上述代码定义了一个 GlobalExceptionHandler。当 Spring MVC 分发请求时,如果 Redis 操作因热点 Key 导致连接池耗尽或超时,抛出 JedisConnectionException,该方法会被触发并返回 503 状态码。这实现了从底层异常到 HTTP 响应的映射。
如何区分普通异常与热点 Key 异常并返回不同状态码
为了更精准地处理热点 Key 问题,建议在业务层或 AOP 切面中识别热点 Key 特征,并将其包装为自定义异常 HotKeyException。这样可以在全局处理器中单独捕获该自定义异常,与普通数据库或网络异常区分开,返回特定的 429 或 503 状态码,便于前端或网关做限流或熔断策略。

import org.springframework.web.bind.annotation.*;
import org.springframework.http.ResponseEntity;
// 自定义异常类
public class HotKeyException extends RuntimeException {
public HotKeyException(String message) {
super(message);
}
}
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(HotKeyException.class)
public ResponseEntity<String> handleHotKey(HotKeyException ex) {
return ResponseEntity.status(429).body("Too Many Requests: Hot Key");
}
@ExceptionHandler(Exception.class)
public ResponseEntity<String> handleGeneric(Exception ex) {
return ResponseEntity.status(500).body("Internal Server Error");
}
}
这段代码展示了如何处理自定义的 HotKeyException。通过在 @ExceptionHandler 中指定 HotKeyException.class,我们可以确保只有当业务逻辑显式抛出此异常(例如检测到访问频率超过阈值)时,才会返回 429 状态码。而通用的 Exception 处理器则作为兜底,捕获其他未知错误。这种分层处理使得热点 Key 的响应更加明确和可控。
当热点 Key 导致 Redis 连接池耗尽时,全局异常处理器的执行顺序是怎样的
当热点 Key 导致 Redis 连接池耗尽时,底层驱动(如 Jedis 或 Lettuce)会抛出连接异常。Spring 的异常处理机制遵循“最匹配优先”原则。如果 @ControllerAdvice 中同时存在对 JedisConnectionException 和 RuntimeException 的处理,前者会被优先选中。若未捕获,异常会向上传播至 DispatcherServlet 的默认处理器,最终可能返回 500 错误。因此,确保自定义异常处理器在优先级上高于通用处理器是关键。


















