spring boot 全局异常处理可以通过配置 @controlleradvice 结合自定义的 exceptionhandler 来捕获 jedis 连接异常。具体做法是定义一个处理类,使用 @exceptionhandler({jedisconnectionexception.class, jedisexception.class}) 注解,并在方法中返回统一的错误响应对象。这样做可以将底层的 jedis 异常转换为 http 4xx 或 5xx 状态码及友好的 json 消息,避免直接暴露堆栈信息。

Jedis 连接异常在 Spring MVC 流程中的传播路径是怎样的
Jedis 连接异常通常发生在 Controller 层调用 Service 层,Service 再调用 Jedis 客户端时。由于 Jedis 客户端抛出的是运行时异常(RuntimeException),它会沿着调用栈向上传播,直到被 Spring MVC 的 DispatcherServlet 捕获。如果未手动处理,Spring 会将其映射为默认的 500 Internal Server Error。通过全局异常处理器,我们可以拦截这些异常并定制响应。

import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.http.HttpStatus;
import redis.clients.jedis.exceptions.JedisConnectionException;
import redis.clients.jedis.exceptions.JedisException;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler({JedisConnectionException.class, JedisException.class})
@ResponseBody
public ErrorResponse handleJedisException(JedisException ex) {
// 记录日志
System.err.println("Jedis Exception: " + ex.getMessage());
return new ErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR.value(), "Redis connection failed");
}
}
class ErrorResponse {
int code;
String message;
public ErrorResponse(int code, String message) {
this.code = code;
this.message = message;
}
}
如何区分 Jedis 连接超时与认证失败等不同类型的异常
Jedis 抛出的异常类型不同,处理方式也应有所区别。例如,JedisConnectionException 通常表示网络问题或连接池耗尽,而 AuthenticationRequiredException 则表示密码错误。在全局异常处理器中,可以分别捕获这些子类异常,或者在同一个处理方法中通过 instanceof 判断异常类型,从而返回不同的错误码和提示信息。

import redis.clients.jedis.exceptions.AuthenticationRequiredException;
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(AuthenticationRequiredException.class)
@ResponseBody
public ErrorResponse handleAuthException(AuthenticationRequiredException ex) {
return new ErrorResponse(401, "Redis authentication failed");
}
@ExceptionHandler(JedisConnectionException.class)
@ResponseBody
public ErrorResponse handleConnectionException(JedisConnectionException ex) {
return new ErrorResponse(503, "Redis service unavailable");
}
}
当 Jedis 连接池耗尽时,全局异常处理能捕获到哪些具体异常
当 Jedis 连接池耗尽时,Jedis 客户端通常会抛出 JedisConnectionException,其内部原因可能是 java.net.SocketTimeoutException 或 redis.clients.jedis.exceptions.JedisDataException。在全局异常处理器中,捕获 JedisConnectionException 即可覆盖这种情况。此外,如果使用了 Lettuce 或其他 Redis 客户端,异常类型会有所不同,但处理思路一致:在 @ControllerAdvice 中捕获对应的运行时异常。











