根本原因是Lua到Redis类型转换规则严格：仅当return值为整数型Lua number（无小数、不溢出int64范围）时才转Redis integer reply，否则降级为bulk string；tonumber()易因空格、浮点精度或非数字字符串导致失败或产生非整数值。
Redis脚本返回 bulk string 而不是 integer，根本原因在于 Lua 到 Redis 的类型转换规则中：只有 Lua number 才能转为 Redis integer reply，且必须满足「整数、无小数、不溢出」三个硬性条件；一旦不符合，就会退化为 bulk string。
redis.call() 返回值自动转成 Lua 类型，但 return 值要反向映射回 Redis 协议
你在脚本里写 return redis.call('incr', KEYS[1])，Redis 先执行 INCR 得到整数 123，再按 RESP 规则把它转成 Lua number（即 123.0）传给脚本上下文。但最终 return 的那个值，要从 Lua 类型重新映射回 Redis 协议 —— 这一步不由命令决定，而由你 return 的 Lua 值类型决定。
-
return 42→ Luanumber→ Redisinteger reply（:42\r\n） -
return 42.0→ 仍是 Luanumber→ Redisinteger reply（只要它在int64_t范围内） -
return 42.5→ Luanumber含小数 → Redisbulk string（$4\r\n42.5\r\n） -
return tostring(42)→ Luastring→ Redisbulk string（$2\r\n42\r\n）
为什么 tonumber() 失效或隐式转成 float 导致 integer 消失
常见错误是用 tonumber() 读取 Redis 字符串值，比如 local stock = tonumber(redis.call('get', KEYS[1]))。表面看没问题，但：
– 如果 GET 返回的是 "100"，tonumber() 得到 100.0，仍算整数，可转 integer reply；
– 但如果 Redis 存的是 "100.0" 或 " 100 "，tonumber() 返回 nil，Lua 把 nil 当作 false，而 false 映射为 Redis Nil bulk reply（$-1\r\n），不是 integer；
– 更隐蔽的是浮点精度问题：tonumber("9223372036854775807") 在 Lua 5.1 下可能变成 9223372036854775808.0，超出 int64 上限，Redis 拒绝转 integer，强制 fallback 成 bulk string。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 检查是否为有效整数：
local n = tonumber(val); if not n or n ~= math.floor(n) or n > 9223372036854775807 or n - 避免空格干扰：
tonumber(string.match(val, "%d+"))比直接tonumber(val)更鲁棒 - 明确截断小数：
math.floor(n)再判断是否在范围内，比依赖tonumber更可控
EVALSHA 和 script load 对返回类型没有影响
有人以为用 SCRIPT LOAD + EVALSHA 能“固定”返回类型，其实完全不影响。脚本内容和 return 表达式没变，类型映射规则就完全一样。区别只在传输开销和缓存复用，跟协议编码无关。
-
SCRIPT LOAD "return 42"→ 返回 SHA，后续EVALSHA xxx 0→ 仍是:42\r\n -
SCRIPT LOAD "return tostring(42)"→EVALSHA后仍是$2\r\n42\r\n - 哪怕脚本里写
return redis.call('hlen', KEYS[1])，只要HLEN返回整数，整个return就是 integer reply —— 因为redis.call()的返回值在进入 Lua 后已被转为 number，而你又原样return它
最易被忽略的点：Redis 不会帮你做类型兜底。它严格按 Lua 类型查表映射，number → integer 是特例而非默认行为。一旦你 return 的值带小数、超范围、或被意外转成 string，integer 就永远消失了 —— 连 debug 都难定位，因为 redis-cli 显示的都是“看起来像数字”的字符串。
