spring boot 全局异常处理捕获红锁失败异常,核心在于确保自定义的 redlockexception 被 spring mvc 的 @exceptionhandler 或 @controlleradvice 正确拦截。具体做法是:在配置类中注册全局异常处理器,并在其中编写针对 redlockexception 的处理方法,返回统一的错误响应结构。这样当分布式锁获取失败时,系统能优雅地降级或返回特定状态码,而不是抛出未处理的运行时异常。

如何定义并抛出红锁失败异常
要捕获异常,首先必须明确异常的类结构和抛出时机。通常我们使用 Redisson 等客户端,当 tryLock 超时或获取失败时,会抛出 IllegalMonitorStateException 或直接返回 false。为了统一处理,建议封装一个自定义异常 RedLockException,并在业务层或 AOP 切面中显式抛出它。这样全局处理器就能精准识别。

package com.example.exception;
public class RedLockException extends RuntimeException {
private final String lockKey;
private final boolean acquired;
public RedLockException(String lockKey, boolean acquired) {
super("Failed to acquire lock: " + lockKey);
this.lockKey = lockKey;
this.acquired = acquired;
}
public String getLockKey() { return lockKey; }
public boolean isAcquired() { return acquired; }
}
在业务代码中,当检测到锁获取失败时,应主动抛出此异常:
RLock lock = redissonClient.getLock("my_lock");
if (!lock.tryLock(10, TimeUnit.SECONDS)) {
throw new RedLockException("my_lock", false);
}
如何配置全局异常处理器
Spring Boot 提供了 @RestControllerAdvice 注解,可以集中处理所有 Controller 抛出的异常。我们需要创建一个配置类,添加 @RestControllerAdvice,并定义一个方法,使用 @ExceptionHandler(RedLockException.class) 来专门处理红锁异常。该方法应返回一个包含错误码、消息和详细信息的 JSON 对象,以便前端或调用方能区分这是锁冲突还是其他服务器错误。

package com.example.config;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import com.example.exception.RedLockException;
import com.example.dto.ApiResponse;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(RedLockException.class)
public ResponseEntity<apiresponse> handleRedLockException(RedLockException ex) {
ApiResponse response = ApiResponse.error(
HttpStatus.CONFLICT.value(),
"Resource busy",
"Lock acquisition failed for key: " + ex.getLockKey()
);
return new ResponseEntity(response, HttpStatus.CONFLICT);
}
@ExceptionHandler(Exception.class)
public ResponseEntity<apiresponse> handleGenericException(Exception ex) {
ApiResponse response = ApiResponse.error(
HttpStatus.INTERNAL_SERVER_ERROR.value(),
"Internal Error",
ex.getMessage()
);
return new ResponseEntity(response, HttpStatus.INTERNAL_SERVER_ERROR);
}
}</apiresponse></apiresponse>
如何处理并发重试逻辑
当红锁失败时,常见的业务策略不是直接报错,而是进行短暂休眠后重试。这需要在异常处理之前或业务层实现重试机制。如果在全局异常处理器中直接返回错误,则无法触发重试。因此,最佳实践是在业务调用处使用重试模板(如 Spring Retry),或者在 catch 块中自行实现指数退避重试。若选择在后端统一处理,可考虑将 RedLockException 转换为特定的 HTTP 状态码,由客户端决定重试,但更推荐在服务端通过 AOP 或装饰器模式自动重试,避免异常传播到控制器层。











