redis lua脚本中不能用hmset动态更新hash部分字段，因hgetall返回扁平数组需手动配对解析，应改用hgetall+手动修改+hset一次性写回，避免覆盖未修改字段。
Redis Lua脚本里不能直接用 HMSET 动态更新部分 Hash 字段
Redis 7.0 之前 HMSET 已被标记为过时，实际推荐用 HSET；更重要的是，Lua 脚本中无法“先读再写”地动态计算字段值——因为 HGETALL 返回的是无序表（table），遍历修改后若直接 HMSET，会丢失原 Hash 中未显式指定的字段，相当于覆盖而非“动态更新”。
常见错误现象：redis.call('HMSET', KEYS[1], unpack(res)) 导致 Hash 其他字段被清空；或遍历时误把 key 和 value 当成同级元素处理。
-
HGETALL返回形如{'a','1','b','2'}的扁平数组，不是键值对 table，需两两配对解析 - 若只打算更新其中几个字段（比如把所有数值字段加 1），必须手动构造新字段列表，不能依赖
unpack(HGETALL(...)) - Redis Lua 不支持
for k,v in pairs(...)直接遍历HGETALL结果，否则会遍历下标而非键值
正确做法：用 redis.call('HGETALL', KEYS[1]) + 手动解析 + HSET 单次提交
核心逻辑是：读出全部字段 → 按需修改特定 key 的 value → 构造 HSET 参数列表（key、field1、value1、field2、value2…）→ 一次性写回。这样既避免多次 round-trip，又不破坏未修改字段。
示例场景：给 Hash 中所有以 "score:" 开头的字段值加 1：
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
local data = redis.call('HGETALL', KEYS[1])
local args = {KEYS[1]}
for i = 1, #data, 2 do
local field = data[i]
local value = tonumber(data[i+1]) or 0
if string.match(field, '^score:') then
table.insert(args, field)
table.insert(args, tostring(value + 1))
else
table.insert(args, field)
table.insert(args, data[i+1])
end
end
return redis.call('HSET', unpack(args))
注意：unpack 在 Redis 内置 Lua（5.1）中可用，但参数总数不能超过 Redis 命令最大参数限制（通常 1024），超量需分批 HSET。
更安全的替代：用 HSCAN 配合游标避免大 Hash 阻塞
当目标 Hash 字段数超过几千，HGETALL 会阻塞 Redis 主线程，且 Lua 脚本执行时间受限（默认 5 秒超时）。此时应改用 HSCAN 分批处理。
-
HSCAN返回结构与HGETALL一致（field/value 交替），但支持游标分页 - 需在 Lua 中实现循环 + 游标管理，不能依赖单次全量读取
- 每次
HSCAN后立即HSET当前批次字段，确保中间状态一致 - 若需原子性保证整个更新过程，仍得靠 EVAL 原子执行——但大 Hash 下建议评估是否真需要强原子性
别忽略 Lua 类型转换和空值陷阱
Redis 返回的所有值都是字符串，nil 不会出现；但 tonumber() 遇到非数字字符串返回 nil，后续 tostring(nil) 得到 "nil"，可能污染数据。
- 用
type(x) == 'number'或正则校验再转换，例如if string.match(v, '^%-?%d+%.?%d*$') then ... end -
HSET接收nil会报错，必须确保每个插入值是 string 或 number（Redis 自动转 string） - 字段名含空格或特殊字符时，
HGETALL照常返回，但注意 Lua 字符串匹配逻辑是否覆盖边界情况
真正麻烦的不是语法，而是把 HGETALL 的扁平结果映射回键值关系时少走一步 i+1，或者忘了 HSET 第一个参数永远是 key —— 这类低级错误在调试时最耗时间。
