能用，但仅限Redis服务器端Lua环境，必须传日志级别和字符串消息两个参数，不支持格式化或table/nil；需配置redis.conf的loglevel和logfile才可见。
redis.log 在 Lua 脚本里能用吗？
能用，但仅限于 Redis 服务器端 Lua 环境（redis.call 执行上下文），且输出不会返回给客户端——它只写入 Redis 的日志文件（或 stdout，取决于 redis.conf 中 loglevel 和 logfile 配置）。很多开发者误以为它像 print() 那样能在控制台看到，结果脚本没报错、也没日志，其实是日志根本没被配置为可查看。
redis.log 的调用方式和参数限制
redis.log() 必须传入两个参数：日志级别（整数）和日志消息（字符串）。不支持格式化占位符（如 %s）、不支持多参数拼接，也不能传 table 或 nil —— 否则脚本直接报错 ERR Error running script (call to f_...): @user_script: line ...: user_script:...: bad argument #2 to 'log' (string expected, got table)。
- 可用级别：
redis.LOG_DEBUG（0）、redis.LOG_VERBOSE（1）、redis.LOG_NOTICE（2）、redis.LOG_WARNING（3） - 消息必须是字符串：用
tostring()包裹变量，比如redis.log(redis.LOG_NOTICE, "key="..tostring(KEYS[1])) - 避免长消息或高频调用：Lua 脚本执行是原子的，日志写入会阻塞当前脚本，大量
redis.log可能拖慢吞吐
为什么本地调试看不到 redis.log 输出？
常见原因有三个：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- Redis 配置了
logfile ""（空字符串），日志实际输出到 stderr，而 docker 容器或 systemd 服务可能未暴露 stderr -
loglevel设置过高（如warning），但你用了redis.LOG_NOTICE（2），会被过滤掉 - 脚本在 Redis Cluster 模式下运行，日志只打在对应 slot 的 master 节点上，你查的是其他节点的日志文件
验证是否生效最直接的方式：临时把 loglevel 改成 notice，logfile 设为绝对路径（如 /var/log/redis/redis.log），然后 tail -f /var/log/redis/redis.log 观察。
替代方案：什么时候不该用 redis.log？
如果目标是调试脚本逻辑（比如判断某分支是否执行）、或需要把中间值返回给应用层，redis.log 完全不合适——它不可见、不可捕获、也不可结构化。此时应：
- 用
return返回调试信息（如return { debug_key = KEYS[1], computed = res }），由客户端解析 - 在脚本关键位置写入一个临时 key（如
redis.call("SET", "debug:trace:"..math.random(1000), tostring(val))），再用redis-cli查看（注意及时DEL） - 对复杂逻辑，先在本地用
lua5.1+redis-lua库模拟测试，避开 Redis 环境干扰
真正依赖 redis.log 的场景其实很窄：只有当你要长期监控某个 Lua 脚本在生产环境的触发频次、输入分布或异常分支时，才值得配好日志落盘并接入日志系统。其它时候，它更像一个“最后手段”的埋点工具。
