java中redis lua脚本实现原子性与高并发安全，核心是单线程执行封装逻辑，需无状态、禁外部依赖、用redis.call()、keys/argv传参、避免耗时操作，并配合java层错误处理与幂等控制。
Java 中使用 Redis 的 Lua 脚本实现原子性与高并发安全，核心在于把多个操作封装进一个 Lua 脚本，由 Redis 单线程执行，天然避免竞态。关键不是“调用脚本”，而是设计脚本时确保逻辑无状态、不依赖外部变量、不包含阻塞或耗时操作。
用 Jedis 或 Lettuce 加载并执行 Lua 脚本
推荐使用 SHA1 校验值缓存脚本，避免每次传输脚本内容，提升性能和网络效率。
- Jedis 示例：先用
scriptLoad加载脚本获取 SHA，后续用evalsha执行；若返回NOSCRIPT错误，再 fallback 到eval - Lettuce 更推荐使用
ScriptCommands.evalSha+ScriptCommands.scriptLoad组合，并配合ScriptOutput类型处理返回值 - 脚本本身必须用
redis.call()调用 Redis 命令，不能用redis.pcall()捕获异常——除非你明确需要忽略某条命令失败，否则会破坏原子语义
脚本设计必须满足原子性前提
Lua 脚本在 Redis 中是原子执行的，但前提是它不主动引入外部依赖或非 Redis 状态。
- 所有数据读写必须通过
KEYS和ARGV传入，禁止硬编码 key 名或从外部查配置 - 避免在脚本里做复杂计算（如循环上万次）、网络请求、文件读写——Redis 会阻塞其他请求
- 典型安全模式：用
if redis.call("exists", KEYS[1]) == 1 then ... end做条件判断，而不是先 get 再 if，防止中间状态被篡改 - 涉及计数或库存扣减时，用
redis.call("decrby", KEYS[1], ARGV[1])直接操作，返回值再判断是否 ≥0，而非分步 get-check-set
Java 层需配合做好错误处理与幂等控制
脚本执行成功 ≠ 业务成功。网络超时、连接中断、脚本返回自定义错误码等情况都得兜底。
- 对 Lua 脚本返回值做语义解析：比如返回
1表示扣减成功，0表示库存不足，-1表示 key 不存在 - 不要依赖脚本执行成功就认为业务完成——例如扣库存后还需发 MQ、更新 DB，这些步骤需单独保证最终一致性
- 若脚本含唯一性校验（如抢购限一人一单），建议在脚本内用
setnx+ 过期时间打标记，避免 Java 层重复提交 - 重试时注意：Lua 脚本本身可重试（幂等），但若脚本已修改了状态（如 decr），重复执行会导致超扣，所以应由业务层控制重试边界（如用 requestId 去重）
常见陷阱与规避方式
很多并发问题不是出在 Redis，而是出在 Java 和 Lua 的协作细节上。
-
KEYS 数量不匹配：Jedis 传参时
eval(script, keys.size(), keys.toArray(), args.toArray())必须严格对应，否则脚本拿不到 key -
数值类型混淆：Lua 中
ARGV全是字符串，需要用tonumber(ARGV[1])转换，否则+会拼接字符串 -
超时未设置：Lettuce 默认脚本执行无超时，建议设置
CommandTimeout，避免慢脚本拖垮整个连接池 -
集群模式限制：Lua 脚本中所有 key 必须落在同一个 slot，否则报
CROSSSLOT错误；可通过{xxx}方式哈希标签强制路由到同一节点
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
