spring boot 全局异常处理可以通过配置 @controlleradvice 结合自定义的 handlerexceptionresolver 或 exceptionhandler 来捕获看门狗续期异常。具体做法是识别 org.springframework.data.redis.connection.redisconnectionexception 或其子类，并在其中查找由 redisson 抛出的 org.redisson.client.handler.commanddecoder$commandtimeoutexception 或 org.redisson.command.commandasyncservice$redissonpromise$1 相关的超时信息。更直接的方式是拦截 org.redisson.misc.redissonexception，检查其消息是否包含 "lock is not acquired" 或 "lock wait timeout" 等关键字，从而区分是锁获取失败还是续期失败。
如何精准定位续期失败的异常类型
要精准定位续期失败，需要关注 RedissonClient 在后台线程中执行续期任务时抛出的异常。通常，续期失败会表现为 org.redisson.client.RedisTimeoutException 或 java.util.concurrent.TimeoutException，且这些异常往往被包装在 org.redisson.misc.RedissonException 中。通过捕获 RedissonException 并检查其 getCause()，可以进一步确认是否为网络超时或 Redis 服务端无响应导致的续期中断。
import org.redisson.api.RLock;
import org.redisson.api.RedissonClient;
import org.redisson.exception.RedissonException;
import org.springframework.stereotype.Component;
@Component
public class LockService {
private final RedissonClient redissonClient;
public LockService(RedissonClient redissonClient) {
this.redissonClient = redissonClient;
}
public void doLockedTask() {
RLock lock = redissonClient.getLock("myLock");
try {
// 尝试获取锁，等待5秒，持有30秒
if (lock.tryLock(5, 30, java.util.concurrent.TimeUnit.SECONDS)) {
try {
// 执行业务逻辑
System.out.println("Executing task...");
} finally {
lock.unlock();
}
} else {
System.out.println("Failed to acquire lock");
}
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
throw new RuntimeException("Interrupted while waiting for lock", e);
} catch (RedissonException e) {
// 这里可能捕获到续期失败或其他Redis相关异常
System.err.println("Redisson exception caught: " + e.getMessage());
// 进一步分析e.getCause()以判断是否为续期超时
}
}
}
上述代码展示了如何在业务层手动捕获 RedissonException。当续期失败时，tryLock 可能会抛出异常，或者在锁持有期间因续期失败导致锁意外释放，进而引发后续操作的异常。通过检查异常链，可以明确区分是初始获取失败还是续期过程中断。
全局异常处理器中如何处理续期异常
在全局异常处理器中，应优先捕获 RedissonException，因为其涵盖了大多数 Redisson 客户端层面的异常。对于续期失败，通常表现为 RedisTimeoutException，这是 RedissonException 的子类。在 @ExceptionHandler 方法中，可以针对 RedisTimeoutException 进行特殊处理，例如记录日志、返回特定的 HTTP 状态码（如 504 Gateway Timeout）或触发重试机制。
import org.redisson.client.RedisTimeoutException;
import org.redisson.exception.RedissonException;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(RedissonException.class)
public ResponseEntity<string> handleRedissonException(RedissonException ex) {
if (ex instanceof RedisTimeoutException) {
// 处理续期超时或命令超时
return ResponseEntity.status(HttpStatus.GATEWAY_TIMEOUT)
.body("Redis operation timed out, possibly due to lease renewal failure.");
}
// 处理其他 Redisson 异常
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
.body("Redisson error: " + ex.getMessage());
}
}</string>
该全局异常处理器示例展示了对 RedissonException 的分类处理。当检测到 RedisTimeoutException 时，返回 504 状态码，提示客户端操作超时，这通常与续期失败有关。对于其他类型的 RedissonException，则返回 500 错误。这种处理方式确保了续期异常能够被正确识别并返回合适的响应。
续期失败时的业务影响与恢复策略
当看门狗续期失败时，最直接的后果是分布式锁提前释放，导致其他线程可能同时进入临界区，引发数据不一致。为了应对这种情况，业务逻辑应具备幂等性，或者在检测到锁意外释放时，能够安全地回滚或重试操作。此外，可以引入监控告警，当续期失败频率升高时，及时通知运维人员排查 Redis 集群或网络问题。
