spring boot 分布式锁需用 redis + lua 脚本实现跨 jvm 原子操作，加锁用 set nx ex 防死锁，解锁须校验 value 防误删，配合业务前缀、动态过期、evalsha 优化及异常降级。
Spring Boot 实现高并发下的分布式锁，核心不是“加个锁就行”，而是解决跨 JVM、跨节点的资源竞争问题。单靠 synchronized 或本地锁完全失效；用 Redis 做锁载体 + Lua 脚本保证操作原子性，才是工业级落地的关键路径。
为什么必须用 Lua 脚本？
Redis 本身是单线程执行命令的，但普通加锁（如 SETNX）和解锁（GET+DEL）是两个独立命令——中间可能被其他客户端插入操作，导致误删锁、锁失效或死锁。Lua 脚本把“判断是否持锁 + 删除”封装成一段逻辑，在 Redis 内部一次性执行，全程不可中断。比如解锁脚本：
if redis.call("get", KEYS[1]) == ARGV[1] then return redis.call("del", KEYS[1]) else return 0 end
这个逻辑在服务端原子完成，避免了客户端网络延迟、超时重试等带来的竞态风险。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
关键实现步骤
- 准备 Lua 脚本文件（如
lock.lua和unlock.lua），放在resources/scripts/下，内容聚焦原子操作，不依赖外部状态 - 配置
StringRedisTemplate（不是泛型RedisTemplate<object object></object>），避免序列化干扰字符串值比较 - 使用
DefaultRedisScript加载脚本，并显式指定返回类型（Boolean.class或Long.class） - 调用
redisTemplate.execute(script, keys, args)，其中keys是 Redis 键名列表，args是传入脚本的参数（如唯一锁标识 value）
加锁与解锁的 Lua 脚本要点
加锁脚本需满足：存在则失败、不存在则设置并带过期时间（防死锁），推荐用 SET key value NX EX seconds 的等效 Lua 封装：
local result = redis.call("set", KEYS[1], ARGV[1], "NX", "EX", ARGV[2]) return result == "OK" and 1 or 0
解锁脚本必须校验 value 是否匹配（防止 A 加锁、B 误删），且只删一次。注意不要用 DEL 简单删除，必须先 GET 再比对。
生产环境必须考虑的细节
- 锁 key 要带业务前缀和唯一标识（如
"order:pay:20260915123456"），避免不同业务互相干扰 - 锁过期时间不能写死，要略大于业务最大执行时间，并配合看门狗机制（如 Redisson）自动续期
- 建议启用
EVALSHA缓存机制：首次用EVAL执行，后续用 SHA1 值调用，减少网络传输和解析开销 - 异常场景兜底：加锁失败要快速失败或降级（如走数据库乐观锁），不能无限重试阻塞请求
