Java Redis 怎么使用 Lua 脚本保证多步缓存操作的原子性执行

星晨姑娘_6922

星晨姑娘_6922

2026-07-30

202人浏览

原创

必须用 lua 脚本而非多次 java 调用,因 redis 单命令原子但跨网络“读-判-写”存在竞态;lua 在服务端一次性执行,由单线程保障原子性,需通过 eval/evalsha 传入 keys 和 argv,并注意脚本耗时、keys 声明及返回类型一致性。

java redis 怎么使用 lua 脚本保证多步缓存操作的原子性执行

Java 中用 Redis 执行多步缓存操作(比如先查库存、再扣减、再设过期)时,靠多次 `redisTemplate` 调用无法保证原子性——中间可能被其他客户端插队修改数据。真正可靠的做法是把整个逻辑写成 Lua 脚本,在 Redis 服务端一次性执行,由 Redis 单线程模型天然保障原子性。

为什么必须用 Lua 而不是 Java 代码控制

Redis 单个命令(如 INCR、GET)本身是原子的,但 Java 端的“读-判-写”三步属于跨网络的多次往返:

  • Java 发送 GET stock → 网络延迟 + Redis 响应
  • Java 判断结果 → 本地 CPU 运算
  • Java 再发 DECR stock → 又一次网络延迟

这期间别的客户端完全可能抢先完成扣减,导致超卖或逻辑错乱。Lua 脚本直接在 Redis 内部运行,整个脚本从开始到结束不被打断,等效于一个“超长命令”。

Java 中调用 Lua 脚本的标准流程

核心是用 Jedis 或 Lettuce 的 eval / evalsha 方法,传入脚本内容和参数:

Java Maven Secondary Analysis
Java Maven Secondary Analysis

分析ZIP压缩包或GitLab仓库中的Java Maven项目,确定二次开发范围、类数量、模块分布及生产相关指标。

下载
  • KEYS 数组:只放真正涉及的 Redis key(如 "stock:1001"),用于脚本内通过 KEYS[1] 引用
  • ARGV 数组:放动态值(如扣减数量 "1"、过期时间 "60"),脚本内用 ARGV[1] 获取
  • 脚本里必须用 redis.call() 调用 Redis 命令,不能用 redis.pcall()(除非需要容错捕获异常)

示例脚本(库存扣减 + 设置过期):

-- stock_decr.lua
local stock = redis.call("GET", KEYS[1])<br>
if not stock or tonumber(stock) 
  return -1  -- 库存不足<br>
end<br>
redis.call("DECRBY", KEYS[1], ARGV[1])<br>
redis.call("EXPIRE", KEYS[1], ARGV[2])<br>
return tonumber(stock) - tonumber(ARGV[1])

Java 代码调用示例(Jedis)

推荐预加载脚本再用 EVALSHA,避免每次传输大段 Lua 文本:

  • 先用 scriptLoad 将脚本上传到 Redis,获取 SHA1 值(如 "a1b2c3...")
  • 后续所有请求都用 evalsha("a1b2c3...", keys, args)
  • 如果 Redis 返回 NOSCRIPT 错误,说明脚本丢失,需重新 scriptLoad 并重试

关键代码片段:

List<string> keys = Arrays.asList("stock:1001");<br>
List<string> args = Arrays.asList("1", "3600");<br>
Object result = jedis.evalsha(sha1, keys, args); // 返回 -1 或剩余库存数</string></string>

生产环境注意事项

Lua 脚本不是万能的,用错反而引发问题:

  • 避免耗时操作:不能用 for i=1,10000 do ... end 这类纯计算循环,会阻塞 Redis 其他请求
  • KEYS 必须显式声明:脚本里访问的所有 key 都得出现在 KEYS 参数中,否则集群模式下会路由失败
  • 返回值类型要一致:Java 接收时按 Long、String 或 List 显式转换,避免 ClassCastException
  • 脚本长度限制:默认最大 512MB(实际远小于此),复杂逻辑建议拆分或改用服务端模块(Redis Modules)

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

9977

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

7122

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

6252

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1084

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

908

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1316

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2629

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19951

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1175

8

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习