Redis Lua脚本返回nil或false，客户端均收到nil（如Python的None、Java的null），无法区分二者；需用table包装（如{return=false}）或Redis 7.0+的debug error主动报错来明确语义。
Redis Lua脚本里返回 nil，客户端收到的是什么？
Redis 的 Lua 执行环境对 Lua 原生类型做了严格限制：只允许返回 nil、number、string、table（必须是数组形式或键为字符串的扁平结构）、boolean。其中 nil 和 false 在返回时会被统一转换为 Redis 协议中的空值（即 RESP NULL Bulk String，表现为 nil）。
这意味着：无论你在 Lua 脚本里写 return nil 还是 return false，Redis 客户端收到的都是 nil（Python 的 None，Java 的 null，Node.js 的 null），**无法区分二者**。
-
return nil→ 客户端收到None（Python）/null（JS/Java） -
return false→ 客户端同样收到None/null -
return {false}→ 客户端收到[False]（可区分，因为封装在 table 中） -
return {ok = false}→ 合法，客户端收到{"ok": False}（键值对形式也保留布尔值）
为什么不能直接用 if result == nil 判断业务逻辑？
因为 nil 既可能来自 Lua 主动返回 nil（例如 key 不存在、条件未命中），也可能来自 return false（你本想表达“失败”语义），但客户端已丢失原始意图。更麻烦的是：某些客户端（如旧版 redis-py）在 pipeline 或 evalsha 场景下，甚至会把 nil 错误转为空列表或空字符串。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 不要依赖
result is None来反推“是用户写了return nil还是return false” - 避免在 Lua 中用
return false表达业务失败——它和return nil在协议层完全等价 - 若需传递布尔语义，必须包装：比如
return {success = false, msg = "not found"} - Redis 7.0+ 支持
redis.call("debug", "error", ...)主动报错，比返回nil更利于客户端分流处理
redis.call() 返回 nil 的常见场景与应对
很多内置命令在无结果时返回 nil，比如 redis.call("GET", "missing:key")、redis.call("HGET", "h", "missing_field")。Lua 脚本中若直接使用这些结果做逻辑判断，容易因隐式类型转换出错。
-
local val = redis.call("GET", "k"); if not val then ... end—— ✅ 安全，nil和false都被视作 falsy -
if val == nil then ...—— ✅ 显式，但冗余；val == false永远为false（因为false已被转成nil） -
if type(val) == "boolean" then ...—— ❌ 永远不会进，false不会以 boolean 形式透出 -
return {val = val}—— ✅ 包装后，客户端能拿到{"val": None}，明确知道字段存在但值为空
客户端解析时最容易忽略的兼容性细节
不同语言客户端对 RESP NULL Bulk String 的映射并不完全一致，尤其在嵌套结构中：
- Python
redis-py≥ 4.0：单值nil→None；{a: nil}→{"a": None}；{nil, "b"}→[None, "b"] - Node.js
ioredis：默认将nil转为null，但若开启returnBuffers: true，nil仍为null，不会变Buffer - Java
lettuce：Value<string></string>类型中nil映射为null；但若用Map<String, String>接收HGETALL结果，缺失字段根本不会出现在 map 中 —— 和 Lua 脚本返回nil是两回事，别混用 - 关键点：永远检查你用的客户端版本文档，确认其对
nil的序列化策略，尤其是 pipeline 或 script load/evalsha 复用场景下
