Redis Lua脚本在低版本（如6.2及更早）中必须使用Lua 5.1语法，禁用goto（仅标签跳转）、table.unpack等新特性，全局变量须声明为local，KEYS/ARGV需显式传入，错误处理依赖redis.pcall，且须严防超时与跨slot访问。
Redis Lua脚本在低版本（如 Redis 6.2 及更早）中无法使用 Redis Functions，必须依赖 EVAL/EVALSHA + 原生 Lua 5.1 环境，兼容性问题主要来自语言特性、API 限制和运行时约束，不是“写对就能跑”，而是“写得够老才能跑”。
用 Lua 5.1 语法写，别碰 5.2+ 新特性
Redis 内置的 Lua 解释器固定为 Lua 5.1（截至 Redis 7.2 仍无变更），goto、table.unpack（需手动展开）、utf8 模块、__gc 元方法等均不可用。常见踩坑点：
-
continue不存在 → 改用if not cond then goto skip end+::skip::（goto是 5.1 支持的，但仅限标签跳转，不能跨作用域） -
table.pack和table.unpack不可用 → 手动构造 table 或用{...}+select拆包 - 全局变量被禁止 → 所有变量必须声明为
local，否则脚本加载失败并报错ERR Error running script (call to f_...): @user_script:line: attempt to assign a global variable - 字符串模式不支持
%u或 Unicode 类匹配 → 避免正则中使用非 ASCII 字符类
KEYS 和 ARGV 必须显式传入，不能硬编码键名
脚本中所有 Redis 键名必须通过 KEYS[1]、KEYS[2] 访问，值参数走 ARGV[1] 等；硬编码键名（如 "user:1001"）会导致脚本无法被缓存，每次调用都走 EVAL 而非 EVALSHA，浪费带宽且失去复用价值。
正确写法示例：
return redis.call('incrby', KEYS[1], ARGV[1])
错误写法（不可缓存、不安全、违反 Redis 集群 key hash tag 规则）：
return redis.call('incrby', 'counter', ARGV[1])
注意：numkeys 参数必须严格等于 KEYS 数组长度，多传或少传都会触发 ERR Error running script (call to f_...): @user_script: line: wrong number of arguments。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
错误处理必须用 redis.pcall，别依赖 redis.call
redis.call 抛异常会直接中断整个脚本执行，返回错误给客户端；而 redis.pcall 返回 {ok=true, result=...} 或 {ok=false, err="..."}，允许你做分支判断。低版本 Redis 不支持 try/catch，这是唯一可控的容错方式。
典型用法：
local res = redis.pcall('hget', KEYS[1], ARGV[1])
if not res.ok then
return {err = res.err}
end
return res.result
特别注意：redis.pcall 对 PUBLISH、SCRIPT KILL 等命令也返回表结构，但某些命令（如 EXPIRE 在 key 不存在时）返回 0（Lua number），不是 error，需按业务逻辑判断，不能只看 ok 字段。
避免超时与阻塞，尤其在 Redis 6.2 之前
低版本 Redis（< 7.0）没有 EVAL_RO 或 FCALL_RO，所有脚本默认可读写；且 lua-time-limit 默认 5 秒不可调低（CONFIG SET lua-time-limit 最小支持 100ms），一旦脚本卡住，整个 Redis 单线程会被锁死。
- 禁止循环内调用
redis.call多次（如 for i=1,1000 do redis.call(...) end），网络延迟虽省了，但 CPU 时间可能超标 - 避免递归、深度嵌套 table 查找、大数组遍历 —— Lua 5.1 的 GC 和 table 性能远弱于新版
- 集群环境下，所有
KEYS必须落在同一 slot，否则报错CROSSSLOT Keys in request don't hash to the same slot，没 fallback 机制
真正容易被忽略的是：脚本里调用 redis.log 不影响执行，但日志等级（redis.LOG_WARNING 等）在低版本中部分无效，且日志内容不会自动截断，过长字符串可能撑爆日志缓冲区导致脚本静默失败。
