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

在Redis中使用Lua脚本实现原子操作时，必须通过redis.call()或redis.pcall()间接调用底层命令，而不能直接写SET、GET等客户端指令；脚本运行于沙箱环境，禁用事务（MULTI/EXEC）、配置修改、慢日志等高危命令，集群下所有key须同slot，返回值类型需谨慎判断（如GET未命中返回false而非nil，EXISTS返回数字0/1），且key和参数必须显式传入、严禁硬编码——这些细节稍有疏忽就会导致本地测试正常、线上集群报错，甚至主从不一致。掌握这些核心约束与最佳实践，是写出安全、可靠、可维护Redis 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 显式传入，不能硬编码在脚本里——否则集群模式直接挂，本地测试却正常，上线才暴露。

今天带大家了解了的相关知识，希望对你有所帮助；关于数据库的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~