Spring Boot 2.7整合Redisson实现分布式锁需严格匹配redisson-spring-boot-starter 3.23.0与Spring Data Redis 2.7.x,配置address(带redis://)、database、codec(JsonJacksonCodec),RLock应设leaseTime=-1启用看门狗,解锁仅在tryLock成功后的finally中调用。

Spring Boot 2.7 中配置 Redisson 实现分布式锁,关键不是“能不能配”,而是“配错一个参数就可能让锁失效”。官方 starter 在这个版本已稳定支持,但必须注意 redisson-spring-boot-starter 与 Spring Data Redis 的版本对齐问题——配错会导致 RedissonClient 根本不注入,或者 RLock 加锁后立刻释放。
确认 starter 与 Spring Data Redis 版本匹配
Spring Boot 2.7 默认使用 Spring Data Redis 2.7.x(底层是 Lettuce 6.2+),但 redisson-spring-boot-starter 3.17.x 默认依赖 redisson-spring-data-27,而早期 3.15.x/3.16.x 并不包含它。直接拉最新版最省事:
<dependency><groupid>org.redisson</groupid><artifactid>redisson-spring-boot-starter</artifactid><version>3.23.0</version></dependency>
如果你用的是旧版 starter(比如 3.17.7),必须显式排除自带的 redisson-spring-data-23,并手动引入匹配的模块:
-
redisson-spring-data-27对应 Spring Data Redis 2.7.x - 不要保留
spring-boot-starter-data-redis中的 Lettuce 依赖,否则会触发双客户端冲突 - 若项目里已有
RedisTemplate,Redisson 会自动接管它,无需额外配置
application.yml 必须写的三项配置
starter 自动装配时,redisson: 下的配置项极少,但漏掉任意一项都会导致连接失败或锁行为异常:
redisson: address: redis://127.0.0.1:6379 database: 0 codec: org.redisson.codec.JsonJacksonCodec
注意:
-
address必须带redis://协议头,写成127.0.0.1:6379会报java.lang.IllegalArgumentException: address can't be null -
database不写默认为 0,但显式声明更安全;Redisson 不支持多库切换,所有锁和对象都落在同一 DB -
codec强烈设为JsonJacksonCodec:默认的FstCodec序列化结果不可读,调试时根本看不出 key 里存了什么
RLock 加锁时 leaseTime 和 waitTime 的实际含义
很多人以为 tryLock(10, 30, TimeUnit.SECONDS) 是“最多等 10 秒,锁有效期 30 秒”,其实不对。真实逻辑是:
-
waitTime = 10:最多阻塞等待 10 秒去抢锁,超时返回false -
leaseTime = 30:仅当传入 > 0 时才禁用看门狗;若传 0 或 -1,则启用看门狗,默认每 10 秒续期一次,续期时间为 30 秒 - 生产环境应传
leaseTime = -1,靠看门狗自动续期;硬写 30 秒极易因 GC 或网络抖动导致锁提前释放
正确写法:
RLock lock = redisson.getLock("order:" + orderId);
if (lock.tryLock(10, -1, TimeUnit.SECONDS)) {
try {
// 扣库存等业务
} finally {
lock.unlock();
}
}
解锁必须在同一个线程调用且不能判空
Redisson 的 unlock() 不是幂等操作。常见错误:
- 在异步线程(如
@Async方法)里 unlock → 报IllegalMonitorStateException - 加锁失败后仍执行
lock.unlock()→ 报NullPointerException或静默失败 - 用
if (lock.isLocked()) lock.unlock()判空 →isLocked()只查本地状态,无法反映 Redis 真实情况
唯一安全的解锁模式是:只在 tryLock() 返回 true 后的 finally 块中调用 unlock(),且不加任何前置判断。
最容易被忽略的一点:Redisson 的锁 key 默认不带前缀,多个服务共用一套 Redis 时,product:1001 这种 key 很可能被其他系统误删。上线前务必通过 Config.setReferenceId("myapp") 或自定义 RedissonClient bean 来隔离命名空间,否则压测时你会发现锁“偶尔失效”——其实是别人删了你的 key。











