Redis Lua脚本需用原子“读-判-写”实现状态变迁，推荐HASH结构存储多字段（如status、updated_at、version），通过HGETALL/HSET原子操作，结合redis.call("TIME")获取时间戳、INCR或version校验防越级跳转，返回结构化结果便于业务判断。
Redis Lua脚本里怎么写状态变迁逻辑
直接用 EVAL 执行带条件判断的Lua脚本，把状态检查和更新包在一个原子操作里。Redis不提供原生状态机支持，得靠Lua自己实现“读-判-写”三步闭环，否则并发下容易覆盖状态。
常见错误是先用 GET 读状态、再用 SET 写——这中间有竞态窗口，两个客户端可能同时读到 "pending"，又都写成 "processing"，导致重复处理。
- 所有状态读取必须在Lua里用
redis.call("GET", KEYS[1])完成 - 状态变更必须用
redis.call("SET", KEYS[1], ARGV[2])或redis.call("HSET", ...)紧跟判断之后 - 用
ARGV[1]传入期望的当前状态，ARGV[2]传入目标状态，增强复用性
eval "local s = redis.call('GET', KEYS[1]); if s == ARGV[1] then redis.call('SET', KEYS[1], ARGV[2]); return 1 else return 0 end" 1 order:123 "pending" "processing"
怎样让一个key支持多状态字段（比如status + updated_at）
别用多个独立key存状态和时间戳，否则Lua里没法原子更新。改用 HASH 结构，把状态、时间、版本号等全塞进一个key，用 HGETALL 一次读，HSET 一次写。
有人试过用 SET 存JSON字符串，但Lua解析JSON开销大、易出错，且Redis 7.0前没内置JSON支持；也有人想用 EXPIRE 配合状态，但过期和状态变更不是原子的，时序一乱就失效。
- 用
HMGET读多个字段，比多次GET更省网络和CPU -
HSET支持一次设多个字段，比如redis.call("HSET", KEYS[1], "status", ARGV[2], "updated_at", ARGV[3]) - 时间戳建议用
redis.call("TIME")获取，避免客户端时间不一致
为什么用 redis.call("INCR") 做状态版本号比用字符串更可靠
纯字符串状态（如 "created" → "confirmed"）没法防重放或越级跳转。加个整数版的 version 字段，每次变迁+1，就能在Lua里校验是否按预期顺序走——比如只允许从 version=2 跳到 version=3，不允许从1直接到3。
有人用 GETSET 想实现CAS，但它只返回旧值、不校验，还是得靠Lua自己比对；也有人误以为 WATCH/MULTI 能替代Lua，但WATCH在高并发下容易失败重试，而Lua是确定性执行，更稳。
- 初始化时用
HSET order:123 status "created" version 1 - Lua里用
local v = tonumber(redis.call("HGET", KEYS[1], "version")) or 0安全取值 - 只允许
v == tonumber(ARGV[1])时才更新，否则返回错误码
脚本返回值怎么设计才方便业务层判断
别只返回 OK 或数字0/1。Lua脚本应明确返回结构化结果：成功时返回新状态和版本号，失败时返回当前实际状态和原因，让调用方不用再查一次Redis。
常见坑是脚本里用 return nil 或空字符串，Java/Python客户端收到后容易当成异常或空指针；还有人把错误信息拼进字符串，结果业务代码得做字符串解析，脆弱又难测。
- 成功：
return { status = new_status, version = new_version, updated_at = ts } - 失败：
return { error = "invalid_transition", current_status = current_s, expected_status = ARGV[1] } - Redis Lua只支持简单类型返回（string/number/table），table会自动转成数组，所以用位置约定语义，比如
{1, "processing", 5}表示成功、状态、版本
真正麻烦的是状态流转规则变多以后，脚本里嵌套if越来越多，可读性断崖下跌。这时候该拆成多个专用脚本，或者把校验逻辑提到应用层预检——Lua只做最后那一下原子落库。毕竟它不是图灵完备的业务引擎，只是状态落地的保险栓。
