spring boot 全局异常处理可以通过配置 @controlleradvice 来捕获 redisson 客户端抛出的 org.redisson.client.redisexception。具体做法是在全局异常处理器中显式声明对 redisexception 的捕获逻辑,因为它是所有 redis 相关异常的父类,能够统一拦截连接断开、命令执行失败等底层错误。

如何区分具体的 Redis 错误类型
在捕获到 RedisException 后,可以通过检查其子类或消息内容来区分具体的错误场景,例如网络超时或键不存在。通常建议优先捕获更具体的异常如 TimeoutException 或 ConnectionFailedException,如果无法细分再回退到通用的 RedisException。

import org.redisson.api.RBucket;
import org.redisson.api.RedissonClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class TestController {
private final RedissonClient redissonClient;
public TestController(RedissonClient redissonClient) {
this.redissonClient = redissonClient;
}
@GetMapping("/test")
public String test() {
RBucket<string> bucket = redissonClient.getBucket("myKey");
// 故意设置一个极短的过期时间或模拟操作
bucket.set("value", java.time.Duration.ofMillis(10));
return "success";
}
}</string>
预期结果:当 Redis 服务不可用或操作超时时,控制台或日志中会记录 org.redisson.client.RedisTimeoutException 或 org.redisson.client.RedisConnectionException,而不会导致应用崩溃。
如何处理 Redisson 锁获取失败的异常
在使用 Redisson 分布式锁时,如果锁获取超时或发生竞争,会抛出 RedisLockException 或 IllegalMonitorStateException。在全局异常处理中,可以针对这些特定异常返回友好的业务错误码,避免将底层锁机制的细节暴露给前端。

import org.redisson.api.RLock;
import org.redisson.api.RedissonClient;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class LockController {
private final RedissonClient redissonClient;
public LockController(RedissonClient redissonClient) {
this.redissonClient = redissonClient;
}
@PostMapping("/lock")
public String acquireLock() {
RLock lock = redissonClient.getLock("myLock");
try {
// 尝试获取锁,等待1秒,持有10秒
if (lock.tryLock(1, 10, java.util.concurrent.TimeUnit.SECONDS)) {
return "Lock acquired";
} else {
return "Lock failed to acquire";
}
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
throw new RuntimeException("Interrupted while waiting for lock", e);
}
}
}
预期结果:如果锁获取超时,tryLock 返回 false,程序进入 else 分支;如果发生中断,则抛出 RuntimeException 并被全局异常处理器捕获。
基于 Redisson 客户端连接池满时的具体表现
当 Redisson 客户端的连接池耗尽且没有可用连接时,会抛出 org.redisson.client.RedisConnectionException 并提示 "Connection pool is full"。在全局异常处理中,可以识别该异常的具体消息,从而触发限流或降级策略。











