一行 YAML 切换后端一个注解覆盖全部场景。灵锁让分布式锁像Transactional一样简单。你是否也在这样写分布式锁// 场景一Redisson 手动加锁RLocklockredissonClient.getLock(order:orderId);try{if(lock.tryLock(3,TimeUnit.SECONDS)){// 业务逻辑}}finally{lock.unlock();}// 场景二换 ZooKeeper重写一遍。// 场景三本地调试注释掉上面的代码。// 场景四上生产换集群模式再重写一遍。六个环境六套锁代码。锁本身的逻辑只占 20%剩下的 80% 都在处理连接、重试、超时、清理。灵锁就是为了消灭这 80%。灵锁是什么灵锁Flexible Lock是一个 Spring Boot Starter提供统一的声明式分布式锁接口。它的核心理念只有一句话你用注解描述锁什么灵锁负责怎么锁。Locking(key#userId - #orderId)publicvoidprocessOrder(StringuserId,StringorderId){// 只管业务锁的事交给灵锁}没有try-finally没有手动unlock()没有后端适配代码。一把注解六个后端零行代码切换。六把锁一个接口后端配置值适用场景JVM 本地锁standalone本地开发、单实例应用Redis 单机redis分布式单节点 RedisRedis 集群redis_cluster生产环境 Redis ClusterRedis 哨兵redis_sentinel高可用 Redis 部署ZooKeeperzookeeper已有 ZK 基础设施的团队空实现none测试环境、临时关闭锁切换只需要一行 YAMLflexible:lock:lockType:redis# 改成 zookeeper重启即可代码不动一行本地开发用standalone测试用none生产用redis_cluster——同一套代码三种姿态。不只是能用而是好用 SpEL 动态锁键锁键支持 Spring 表达式语言SpEL可以引用方法参数、甚至 Spring Bean// 引用方法参数Locking(keyorder- #orderId)publicvoidupdateOrder(StringorderId){...}// 调用 Spring Bean 生成动态键Locking(keysystemClock.getTime() - #userId)publicvoidsyncUserData(StringuserId){...}表达式编译结果会被缓存热路径上零重复解析开销。 三种重试策略从容应对竞争策略行为适用场景固定等待每次等待相同时间常规场景指数退避等待时间翻倍含溢出保护高竞争场景随机退避在区间内随机等待避免惊群效应flexible:lock:waitTime:3000# 基础等待 3 秒retryCount:3# 最多重试 3 次retryStrategyType:exponential# 指数退避⚡ 传输故障快速失败当 Redis 连接断开、ZooKeeper 超时时灵锁立即中断重试循环而不是傻傻地烧完所有重试次数。根因异常完整保留排查问题不再靠猜。lockType: none——优雅地不锁这是灵锁最被低估的特性。测试环境不需要锁lockType: none。所有Locking注解瞬间变成空操作无需删代码、无需改逻辑、无需加if判断。这不仅仅是方便——它意味着你的测试可以在无锁环境下全速运行而生产代码一行不改。 无缝集成现有基础设施已经在用RedissonClient或CuratorFramework灵锁会自动检测不会重复创建连接池。你的现有配置灵锁直接复用。 资源清理善始善终所有连接池都注册了destroyMethod shutdown。Spring 容器关闭时Redis 连接、ZooKeeper 会话会被干净地释放不会有连接泄漏的幽灵。类级注解批量生效精准覆盖Locking(keyorder- #orderId,waitTime5000)ServicepublicclassOrderService{// 继承类级配置锁 order-{orderId}等待 5 秒publicvoidcreate(Orderorder){...}// 方法级覆盖换锁键不重试Locking(keystrict- #orderId,retryCount0)publicvoidforceUpdate(Orderorder){...}// 不加注解 不锁publicOrderfindByOrderId(StringorderId){...}}继承、覆盖、豁免三层控制粒度一个注解搞定。技术细节见微知著Redisson 看门狗自动续期锁不会在业务执行期间意外过期ZooKeeper Digest ACL 支持安全集群也能用市面上多数 Starter 缺失此能力溢出安全的退避算法指数退避有位移溢出保护随机退避用long运算避免int截断本地锁的不删除设计解锁时不移除 Map 条目——移除会破坏互斥性灵锁选择了正确的那条路解锁失败不吞异常方法体异常与解锁异常分别处理不会互相掩盖快速开始dependencygroupIdio.github.wb04307201/groupIdartifactIdflexible-lock-spring-boot-starter/artifactIdversion1.1.9/version/dependency# application.ymlflexible:lock:lockType:redisredis:host:redis://127.0.0.1port:6379Locking(key#userId)publicvoidupdateUser(StringuserId){// 就这么简单}三步。从零到跑通一个分布式锁。谁在用灵锁初创团队从单机到集群一套锁代码平滑过渡不欠技术债中大型企业多环境dev/test/staging/prod统一代码配置驱动切换中间件团队作为基础设施组件集成到内部框架提供锁能力给业务方写在最后分布式系统够复杂了分布式锁不该是其中之一。灵锁不重新发明轮子——它站在 Redisson 和 Curator 的肩膀上把那些连接管理、重试逻辑、资源清理、环境切换的脏活累活封装成一个优雅的Locking注解。你负责思考业务灵锁负责锁住混乱。GitHubwb04307201/flexible-lock许可证Apache 2.0Maven Centralio.github.wb04307201:flexible-lock-spring-boot-starter:1.1.9如果这篇文章对你有帮助欢迎 Star ⭐ 支持你的一个小星星是开源作者最大的动力。