Redis怎样在Lua脚本中实现日志打印_利用redis.log进行调试-Redis-PHP中文网

redis.log 仅限 redis 服务器端 lua 环境使用，需通过 redis-cli eval 等方式执行；参数首为日志级别常量，后续为字符串，nil 值须用 tostring() 转换，日志长度超 1024 字节被截断，且受 redis.conf 中 loglevel 配置影响。

redis怎样在lua脚本中实现日志打印_利用redis.log进行调试

redis.log 函数只能在 Redis 服务器端 Lua 环境中使用，不能在本地 Lua 解释器里调用

Redis 提供的 redis.log 是专为 Lua 脚本调试设计的服务器端日志接口，它会把日志写入 Redis 的 redis-server 日志文件（如 redis.log），而不是输出到控制台。这意味着你必须通过 redis-cli EVAL 或其他 Redis 客户端执行脚本，才能看到效果；直接用 lua script.lua 运行会报错 attempt to call a nil value (global 'redis')。

常见错误现象：在本地写好 Lua 脚本后直接运行，发现没输出、没报错、也没日志——根本原因是 redis 表只存在于 Redis 内嵌 Lua 环境中，外部 Lua 不认识它。

redis.log 第一个参数必须是日志级别常量：redis.LOG_DEBUG、redis.LOG_VERBOSE、redis.LOG_NOTICE、redis.LOG_WARNING
第二个及以后的参数是字符串（支持 string.format 风格占位符，但不支持自动类型转换，非字符串需显式转）
日志内容长度超过 1024 字节会被截断，超长调试信息建议拆分或取关键字段

日志级别影响是否可见，必须确保 redis.conf 中 loglevel ≥ 对应级别

Redis 默认 loglevel 是 notice，所以用 redis.LOG_DEBUG 打印的日志默认不会写入日志文件。如果你在脚本里写了 redis.log(redis.LOG_DEBUG, "key=%s", KEYS[1]) 却看不到，大概率是配置没调。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

检查当前配置：CONFIG GET loglevel，返回值可能是 ["loglevel","notice"]
临时提升级别（重启不生效）：CONFIG SET loglevel debug
永久生效需修改 redis.conf 中 loglevel debug 并重启服务
redis.LOG_WARNING 和 redis.LOG_NOTICE 在默认配置下即可输出，适合生产环境轻量调试

KEYS 和 ARGV 变量可直接拼接打印，但 nil 值会导致 redis.log 报错

在 Lua 脚本中访问 KEYS[1] 或 ARGV[2] 时，如果对应位置为空（比如没传参），值是 nil。而 redis.log 不接受 nil 作为格式化参数，会直接中断脚本并返回错误 ERR Error running script (call to f_...): @user_script:3: user_script:3: bad argument #2 to 'log' (string expected, got nil)。

安全写法：用 tostring() 包裹所有可能为 nil 的变量，例如 redis.log(redis.LOG_NOTICE, "key=%s, arg=%s", tostring(KEYS[1]), tostring(ARGV[1]))
避免用 .. 拼接字符串再传给 redis.log，因为 nil .. "str" 会触发运行时错误
调试复杂结构（如 table）时，不要直接传整个 table，可用 cjson.encode()（需 Redis 加载 cjson 模块）或手写简单遍历