redis.log()是Redis Lua脚本唯一可用的调试输出方式，仅支持两个参数（日志级别和预拼接字符串），不支持print或格式化；需用tostring()显式转换变量并避免nil拼接，且日志等级须匹配redis.conf配置。
Redis Lua脚本里 redis.log() 是唯一可用的调试输出方式
Redis 不支持 print()、io.write() 或任何标准 Lua 的 I/O 函数，所有输出必须走 redis.log()。它只接受两个参数：level（如 redis.LOG_DEBUG）和 message（字符串，不支持格式化或拼接变量）。
常见错误是直接写 redis.log(redis.LOG_DEBUG, "count:", count) —— 这会报错 ERR Error running script (call to f_...): user_script:1: wrong number of arguments，因为 redis.log() 不支持多参数。
- 正确写法：用
..拼接字符串，例如redis.log(redis.LOG_DEBUG, "count=" .. tostring(count)) - 注意
tostring()必须显式调用，对nil、table等类型尤其关键；对table可先用cjson.encode()（需提前redis.call("eval", "return require('cjson')", {})验证模块可用） - 日志等级建议从
redis.LOG_WARNING开始，避免被 Redis 日志淹没；生产环境记得删掉或注释掉redis.log调用
本地模拟执行时，redis.call() 和 redis.pcall() 行为与真实环境不一致
在本地用纯 Lua 解释器（如 lua 命令）跑脚本会失败，因为 redis.call() 依赖 Redis 服务上下文。但你可以用 redis-cli --eval 在开发机直连测试，更接近真实场景。
典型陷阱是误用 redis.pcall() 捕获异常后忽略返回值结构：它总是返回两元素 table，ok 字段为 boolean，err 或结果在第二个位置。直接取 res[2] 而不检查 res[1] 会导致逻辑错判。
- 推荐写法：
local res = redis.pcall("get", "key"); if not res[1] then return res[2] end; local val = res[2] - 不要在脚本里调用未启用的命令（如
redis.call("bf.exists")），否则报ERR unknown command，且不会触发pcall的 error 分支——它直接中断脚本 -
redis.call()抛异常会终止整个脚本；redis.pcall()不会，但必须手动处理返回值，否则后续逻辑可能基于 nil 运行
脚本超时或原子性破坏常因循环 + 多 key 操作引发
Redis 执行 Lua 脚本是单线程原子的，但耗时过长会阻塞其他请求。常见错误是用 for 循环逐个 redis.call("get", key) 查上百个 key，而不是改用 redis.call("mget", ...) 一次获取。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
另一个隐蔽问题是脚本里混用读写操作却没保证 key 模式一致。例如用 KEYS[1] 写入、ARGV[1] 作为 key 名去读——这违反了 Redis 的 key hash tag 规则，集群模式下直接报 ERR hash slot not covered。
- 务必确保所有涉及的 key 都声明在
KEYS数组中，且脚本内只通过KEYS[i]引用 - 避免在循环中调用
redis.call()；优先用批量命令（mget/mset/evalsha预加载） - 用
redis.call("exists", KEYS[1]) == 1判断存在性，别用redis.call("get", KEYS[1]) ~= nil——前者更快，且避免空字符串干扰
调试时最容易被忽略的是客户端传参类型和编码问题
Redis 协议把所有 ARGV 当作字符串传递，即使你用 redis-cli --eval script.lua key1 key2 -- 123 true，ARGV[1] 也是 "123"，ARGV[2] 是 "true"，不是 number 或 boolean。
常见错误是直接比较 if ARGV[1] == 1 then，结果永远 false；或用 tonumber(ARGV[1]) 但没处理 nil 返回值，导致后续计算出错。
- 显式转换并校验：
local limit = tonumber(ARGV[1]); if not limit or limit - 布尔值建议用约定字符串，如
"1"/"0"或"true"/"false"，再用ARGV[2] == "1"判断 - 如果需要 JSON 结构参数，客户端应先
json.encode()，脚本里用cjson.decode(ARGV[n])解析——但注意cjson在部分 Redis 版本（
脚本逻辑错往往藏在类型隐式转换和 key/argv 边界上，而不是算法本身。每次修改后，用最小可复现 case + redis.log() 打点，比反复猜更快。
