Redis 的 Lua 脚本功能是什么？如何使用？

Redis Lua 脚本功能详解

【核心定义】

Redis Lua 脚本功能是一种将多个Redis命令组合成一个原子性操作的服务器端脚本执行机制，其本质是在Redis服务器内部以单线程、原子性的方式执行Lua脚本代码，从而避免客户端-服务器多次往返通信和并发竞争条件。

【关键要点】

原子性保证
整个Lua脚本在执行期间不会被其他命令插入，所有操作要么全部成功，要么全部失败回滚，这是Redis单线程模型和EVAL命令的原子语义保证的。
减少网络开销
将多个命令打包成一个脚本执行，减少客户端与服务器之间的网络往返次数（RTT），特别适合批量操作场景。
复杂逻辑封装
支持条件判断、循环等Lua语言特性，可以在服务器端实现复杂的业务逻辑，如分布式锁的续期、限流算法等。
脚本缓存优化
使用SCRIPT LOAD和EVALSHA可以缓存脚本的SHA1摘要，避免重复传输脚本源码，提升性能。

【深度推导/细节】

原子性实现原理

Step 1 - 脚本提交
客户端通过EVAL "script" numkeys key [key ...] arg [arg ...]命令将Lua脚本发送到Redis服务器。

Step 2 - 单线程执行
Redis主线程（单线程）按顺序执行脚本中的所有Redis命令，在此期间：

不会处理其他客户端的命令请求
所有中间状态对其他客户端不可见
脚本中的错误会导致整个脚本回滚

Step 3 - 结果返回
脚本执行完毕后，将最终结果返回给客户端，然后Redis才能处理下一个命令。

脚本复用与缓存机制

-- 首次执行（传输源码）
EVAL "return redis.call('GET', KEYS[1])" 1 mykey

-- 缓存脚本并获取SHA1
SCRIPT LOAD "return redis.call('GET', KEYS[1])"
-- 返回：'abcdef123456...' (SHA1摘要)

-- 后续执行（使用缓存）
EVALSHA 'abcdef123456...' 1 mykey

关键参数设计

KEYS数组：必须显式声明脚本访问的所有键名，这是Redis集群模式下路由正确性的保证
ARGV数组：传递非键名的参数，如数值、标志位等
numkeys参数：明确分隔KEYS和ARGV的边界，防止键名被误解析为参数

【关联/对比】

Redis事务 vs Lua脚本

特性	MULTI/EXEC事务	Lua脚本
原子性	弱原子性（仅保证顺序执行）	强原子性（执行期间不穿插其他命令）
回滚能力	不支持回滚（仅取消事务）	支持错误回滚
条件判断	不支持	支持Lua条件逻辑
性能	多次RTT	单次RTT
集群支持	有限制（需所有键在同一slot）	需通过hash tag确保键在同一节点

Lua脚本 vs Redis模块

Lua脚本：轻量级、临时性逻辑，适合业务层组合操作
Redis模块：C语言编写，高性能、持久化，适合底层功能扩展（如RedisSearch、RedisJSON）

【线程安全与版本差异】

线程安全保证

Redis 6.0+ 引入了多线程I/O，但Lua脚本执行仍由主线程串行处理，保证了：

脚本内的数据访问无需加锁
不会出现竞态条件
但长时间运行的脚本会阻塞整个Redis实例（需设置lua-time-limit）

版本演进关键点

Redis 2.6+：引入Lua脚本支持
Redis 3.2+：引入redis.replicate_commands()，支持脚本的部分命令复制到AOF和从节点
Redis 5.0+：改进Lua调试器和错误处理
Redis 7.0+：支持函数式API（redis.register_function），提供更好的脚本管理

保护机制

执行超时控制（默认5秒）
```
config set lua-time-limit 5000
```
超时后可通过SCRIPT KILL终止只读脚本，或SHUTDOWN NOSAVE强制停止
内存限制 Lua脚本使用的内存计入Redis总内存，受maxmemory限制
沙箱环境 禁用危险函数（如文件操作、网络访问），仅开放Redis API和安全的Lua库

『面试官追问』

Q1：Lua脚本在Redis集群中有什么限制？

A：Redis集群要求一个Lua脚本操作的所有键必须位于同一个hash slot，否则会返回-CROSSSLOT错误。解决方案：

使用hash tag确保相关键在同一slot：{user:1000}:profile、{user:1000}:orders
将逻辑拆分为多个脚本，每个脚本操作同一slot的键
Redis 7.0+支持函数式API，提供了更好的集群兼容性

Q2：如何调试有问题的Lua脚本？

A：调试方法包括：

日志调试：在脚本中使用redis.log()输出日志

redis.log(redis.LOG_NOTICE, "Key value: " .. redis.call("GET", KEYS[1]))

Redis CLI调试：使用redis-cli --ldb进入交互式调试器
慢日志监控：通过SLOWLOG GET查看执行时间过长的脚本
监控命令：使用INFO commandstats统计脚本执行情况

Q3：Lua脚本执行失败会回滚吗？

A：分两种情况：

语法错误/编译错误：脚本不会执行，无任何影响
运行时错误：
- 如果是业务逻辑错误（如对字符串执行INCR），已执行的命令不会回滚
- 如果是Redis命令执行错误，该命令失败但后续命令继续执行
- 只有调用redis.call()时Redis命令失败才会抛出Lua错误终止脚本

Q4：生产环境使用Lua脚本的最佳实践？

A：

脚本尽量简短：避免长时间运行阻塞Redis
显式声明KEYS：确保集群模式正常工作
使用SCRIPT LOAD/EVALSHA：减少网络传输
设置超时监控：配置lua-time-limit和监控告警
版本控制：对脚本内容进行版本管理，避免缓存不一致

错误处理：在脚本中加入pcall()错误捕获

local ok, result = pcall(redis.call, "GET", "nonexistent")
if not ok then
    return "Error: " .. result
end

Q5：Lua脚本与Redis事务在原子性上的本质区别？

A：根本区别在于隔离级别：

Lua脚本：真正的原子性，执行期间Redis不处理其他命令（类似数据库的串行化隔离）
Redis事务：仅保证命令按顺序执行，但其他客户端的命令可能在事务命令之间执行（类似数据库的读已提交隔离）

这种差异源于实现机制：Lua脚本在Redis内部作为一个命令单元执行，而事务只是一组命令的批量执行标记。

总结要点：Redis Lua脚本的核心价值在于原子性+减少网络开销，是复杂Redis操作的优选方案。使用时需注意集群限制、性能影响和错误处理，合理利用脚本缓存提升性能。在分布式系统中，Lua脚本是实现原子操作和减少客户端-服务器交互次数的关键工具。

# Redis 的 Lua 脚本功能是什么？如何使用？