讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

在Spring Boot 2.7中如何配置Redisson实现分布式锁?

夏萱吖_4011

夏萱吖_4011

发布时间:2026-11-18 09:41:26

|

958人浏览过

|

来源于php中文网

原创

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实现分布式锁?

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

注意:

Sentinal Redis
Sentinal Redis

监控Redis服务器健康状况、内存、性能及BullMQ队列。检查队列深度、失败任务,分析慢查询并诊断问题。

下载
  • 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。

热门AI工具

更多
UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

函子Zion

一款支持AI搭建、可视化编辑和多端发布的全栈无代码开发平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

3031

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

537

2026.01.26

什么是分布式
什么是分布式

分布式是一种计算和数据处理的方式,将计算任务或数据分散到多个计算机或节点中进行处理。本专题为大家提供分布式相关的文章、下载、课程内容,供大家免费下载体验。

2233

2023.08.11

分布式和微服务的区别
分布式和微服务的区别

分布式和微服务的区别在定义和概念、设计思想、粒度和复杂性、服务边界和自治性、技术栈和部署方式等。本专题为大家提供分布式和微服务相关的文章、下载、课程内容,供大家免费下载体验。

3794

2023.10.07

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5029

2023.11.02

内存数据库有哪些
内存数据库有哪些

内存数据库有Redis、Memcached、Apache Ignite、VoltDB、TimesTen、H2 Database、Aerospike、Oracle TimesTen In-Memory Database、SAP HANA和ache Cassandra。更多关于内存数据库相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

4615

2023.11.14

mongodb和redis哪个读取速度快
mongodb和redis哪个读取速度快

redis 的读取速度比 mongodb 更快。原因包括:1. redis 使用简单的键值存储,而 mongodb 存储 json 格式的数据,需要解析和反序列化。2. redis 使用哈希表快速查找数据,而 mongodb 使用 b-tree 索引。因此,redis 在需要高性能读取操作的应用程序中是一个更好的选择。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

9012

2024.04.02

redis怎么做缓存服务器
redis怎么做缓存服务器

redis 作为缓存服务器的答案:redis 是一款开源、高性能、分布式的键值存储,可作为缓存服务器使用。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

683

2024.04.07

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Go-Zero官方文档
Go-Zero官方文档

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn