Redis Lua脚本中不能直接执行SET等命令，必须通过redis.call()或redis.pcall()调用；MULTI/EXEC等事务命令禁用；所有key需显式传入，集群下须同slot；返回值类型需手动判断，避免误判false/0。
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 显式传入，不能硬编码在脚本里——否则集群模式直接挂，本地测试却正常，上线才暴露。
