直接用 HSET + HINCRBY 无法保证多级购物车原子性,因 HINCRBY 不支持 JSON 内字段操作,而客户端先读后写会引发并发覆盖;需用 Lua 脚本在服务端原子解析、合并、序列化 JSON。

为什么直接用 HSET + HINCRBY 无法保证多级购物车原子性?
购物车数据常设计为「用户 → 商品 → SKU → 数量/属性」的嵌套结构,比如用哈希存储用户所有商品:cart:1001,每个 field 是 sku:2001,value 是 JSON 字符串 {"count":2,"selected":true,"attrs":{"color":"red"}}。此时若要「增加某 SKU 数量并更新选中状态」,单靠客户端先 HGET、再解析 JSON、修改、再 HSET,必然存在并发覆盖风险——两个请求同时读到旧值,各自加 1 后写回,结果只 +1 而非 +2。HINCRBY 只适用于纯数字字段,对 JSON 内部字段无效。
用 EVAL 执行 Lua 脚本实现真正原子更新
Redis 的 Lua 执行是原子的,且脚本内可调用 redis.call("HGET", KEYS[1], ARGV[1]) 读取、redis.call("HSET", KEYS[1], ARGV[1], new_json) 写入,全程无网络往返。关键点在于:JSON 解析与拼装必须在 Lua 中完成,不能依赖客户端。
- 使用
cjson库(Redis 内置,无需额外安装)解析和序列化 JSON -
KEYS[1]固定为购物车 key(如cart:1001),ARGV[1]为 SKU ID(如sku:2001),ARGV[2]为要合并的字段 JSON(如{"count":1,"selected":true}) - 若 field 不存在,需初始化默认结构,避免
cjson.decode(nil)报错 - 脚本返回值建议设为更新后的完整 value,便于客户端校验
eval "local data = redis.call('HGET', KEYS[1], ARGV[1]); local obj = data and cjson.decode(data) or {}; for k,v in pairs(cjson.decode(ARGV[2])) do obj[k] = v end; redis.call('HSET', KEYS[1], ARGV[1], cjson.encode(obj)); return cjson.encode(obj)" 1 cart:1001 sku:2001 '{"count":1,"selected":true}'
常见踩坑:JSON 空值、嵌套对象合并、Lua 内存限制
Lua 脚本不是万能胶,尤其处理购物车这种可能含多层嵌套的结构时,容易忽略边界:
-
cjson.decode()遇到nil或非法 JSON 直接报错,必须用data and cjson.decode(data) or {}做防御 - 如果
ARGV[2]传的是{"attrs":{"size":"L"}},而原数据已有{"attrs":{"color":"red"}},默认行为是整个attrs被替换,不是深度合并——需要手写递归 merge 函数,或改用更扁平的 key 设计(如用sku:2001:attrs:color单独存) - 单次 Lua 脚本执行内存不能超过 512MB(实际建议控制在几 KB 内),避免对整个购物车
HGETALL后遍历处理;更新必须定向到单个 SKU - Redis 7.0+ 支持
FCALL调用已注册函数,但首次仍需FUNCTION LOAD,生产环境建议预加载,避免每次 EVAL 传输重复脚本
替代方案:用 JSON.SET + JSON.NUMINCRBY(Redis Stack)
如果你用的是 Redis Stack(或 7.4+ 社区版带 JSON 模块),可直接用原生 JSON 命令,比 Lua 更简洁、易读、易调试:
-
JSON.SET cart:1001 $.skus."sku:2001" '{"count":1,"selected":true,"attrs":{"color":"red"}}'初始化 -
JSON.NUMINCRBY cart:1001 $.skus."sku:2001".count 1原子增数量 -
JSON.SET cart:1001 $.skus."sku:2001".selected true单字段更新
但注意:JSON.SET 默认是覆盖,不是 merge;若需局部更新嵌套字段,得确保路径存在,否则报错 ERR could not perform operation on path,得配合 JSON.MGET + 条件判断,反而变复杂。
Redis 处理多级购物车的核心约束始终是:原子性只作用于单次命令或单个 Lua 执行上下文,任何跨 key、跨 field 的“逻辑事务”都得靠设计规避——要么压平结构用原生命令,要么把合并逻辑收进 Lua,别指望客户端补救。











