Redis Lua脚本调用底层命令方法

Redis Lua脚本运行在严格沙箱环境中，无法直接执行SET、EXEC等原生命令，必须通过redis.call()或redis.pcall()安全调用；它禁用事务、配置、管理类命令，要求所有key显式传入且集群下同slot，返回值类型需手动判别（如GET未命中返回false而非nil），并警惕redis.replicate_commands()带来的确定性与兼容性风险——掌握这些核心约束，才能写出高效、可靠、可跨环境部署的原子化Lua脚本。

Redis Lua脚本里不能直接执行 EXEC 或 SET 这类客户端命令

Redis 的 Lua 环境是沙箱化的，只暴露了 redis.call() 和 redis.pcall() 两个入口函数来调用 Redis 命令。你写 SET key value 会报错：ERR unknown command 'SET' —— 因为那不是 Lua 语法，而是 Redis 协议指令。

正确做法是把所有 Redis 操作都包进 redis.call() 或 redis.pcall() 里：

local res = redis.call('SET', 'mykey', 'hello')
local val = redis.call('GET', 'mykey')

• redis.call() 遇错直接中断脚本并抛出错误（类似 throw）
• redis.pcall() 遇错返回一个带 err 字段的 table，不会中断（类似 try/catch）
• 所有命令名和参数都要作为独立字符串传入，不能拼接命令字符串，比如 redis.call('SET mykey hello') 是错的

哪些 Redis 命令能在 Lua 里安全调用

绝大多数原生命令都支持，但有硬性限制：不能调用涉及连接状态、慢日志、配置修改、发布订阅（PUBLISH 除外）、调试类（如 DEBUG）等命令。常见被禁用的有：SAVE、SHUTDOWN、CLIENT LIST、CONFIG SET、MONITOR。

• 事务相关命令（MULTI、EXEC、DISCARD）完全不可用 —— Lua 脚本本身就是原子执行单元，不需要手动开事务
• PUBLISH 可用，但发布的消息不会被当前连接的订阅者收到（pub/sub 不在 Lua 上下文里生效）
• 集群模式下，所有 key 必须落在同一个 slot，否则 redis.call() 会报 CROSSSLOT 错误

redis.call() 返回值类型必须手动判断

Redis 命令返回类型不统一：有些返回字符串（GET），有些返回数组（LRANGE），有些返回整数（INCR），还有些返回 nil（GET 未命中）。Lua 里没法靠类型推断，容易在后续操作中出错。

• GET 找不到 key 时返回 false（不是 nil），所以 if val == nil 判空会失效，得用 if not val
• EXISTS 返回的是数字 0 或 1，不是布尔值，别直接塞进 if 条件里当真值用（Lua 中 0 是 true）
• 对 redis.call('HGETALL', key) 返回的 table，它其实是“扁平数组”（k1,v1,k2,v2…），不是 map，需要用 redis.unpack() 或循环成对取值

慎用 redis.replicate_commands()（仅限 Redis 3.2+）

默认情况下，Lua 脚本在主从复制时是以“整个脚本体 + 参数”方式传播的（script replication），而不是传播执行后的每条命令。这要求从库也必须加载相同脚本（通过 SCRIPT LOAD），否则同步失败。

加一句 redis.replicate_commands() 可切换为“命令传播”模式，让每条 redis.call() 都单独发到从库 —— 听起来更可靠？但实际埋坑不少：

• 开启后，脚本里所有命令必须满足“确定性”，比如不能用 TIME、RANDOMKEY、SRANDMEMBER 等非确定命令，否则从库回放结果不一致
• 如果脚本里用了 redis.call('EVALSHA', ...) 嵌套执行其他脚本，嵌套部分不会自动继承该设置，得各自显式调用
• AOF 重写时，命令传播模式会产生大量冗余写入，可能拖慢 AOF rewrite 速度

除非你明确需要跨分片或兼容旧从库，否则别碰它。默认 script replication 更稳妥。

最常被忽略的一点：Lua 脚本里的 key 和 arg 参数，必须通过 EVAL 或 EVALSHA 的 keys 和 argv 显式传入，不能硬编码在脚本里——否则集群模式直接挂，本地测试却正常，上线才暴露。

今天关于《Redis Lua脚本调用底层命令方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！