Redis Lua脚本无法保证跨实例数据迁移的端到端原子性，仅能保障单实例内操作的原子性；其适用场景限于同一实例内的key重组、状态锁定及进度标记更新等本地操作。
Redis Lua 脚本在数据迁移场景中**无法自动确保端到端原子性**，它只能保证「脚本内对 Redis 的操作」这一小段逻辑的原子执行——迁移涉及源库、目标库、网络、客户端状态等外部环节，这些都不在 Lua 的控制范围内。
为什么 EVAL 不能解决跨实例迁移的原子性
数据迁移通常指从一个 Redis 实例（或集群）向另一个实例同步 key，比如 GET 某个 key 后 SET 到另一台机器。Lua 脚本只能运行在单个 Redis 实例内部，redis.call() 完全无法访问其他实例的连接或数据。
-
redis.call("GET", KEYS[1])只能读当前实例的 key，不能读远端 - 脚本里写
http.request或os.execute会直接报错：@user_script:1: attempt to call a nil value - 即使把迁移逻辑拆成「源端 GET + 目标端 SET」两步，中间网络失败、客户端崩溃、目标端拒绝写入等问题，Lua 都无能为力
真正能用 Lua 做原子保障的迁移子环节
只有当迁移动作完全发生在同一 Redis 实例内时，Lua 才有用武之地。典型场景是「本地 key 重组」或「迁移前的状态快照锁定」：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 把多个旧格式 key 合并写入一个新 hash：用
redis.call("HSET", KEYS[1], ...)+redis.call("DEL", KEYS[2], KEYS[3])封装成单脚本，避免中间状态残留 - 迁移前检查并标记 key 状态：
if redis.call("EXISTS", KEYS[1]) == 1 and redis.call("GET", KEYS[2]) == "ready" then redis.call("SET", KEYS[3], "migrating") ...，防止并发迁移冲突 - 原子性地更新迁移进度标记：
redis.call("INCR", "migrate:progress:shard1")和redis.call("LPUSH", "migrate:log", ARGV[1])绑定执行，避免日志和计数不一致
KEYS 声明错误会导致集群迁移直接失败
在 Redis Cluster 模式下做本地迁移（比如把 user:1001:profile 和 user:1001:settings 合并），必须确保所有 KEYS 属于同一个 slot，否则报错：CROSSSLOT Keys in request don't hash to the same slot。
- 错误写法：
KEYS[1] = "user:"..ARGV[1]..":profile"—— Redis 无法静态分析 key，集群拒绝执行 - 正确写法：客户端提前计算 slot，只传真实 key 名，例如
EVAL "... "2 user:1001:profile user:1001:settings "user:1001:profile" "user:1001:settings" - 如果 key 分布天然跨 slot（如不同用户前缀），就别硬凑进一个脚本，改用客户端分批 + 幂等重试
最容易被忽略的是：迁移过程中若依赖 Lua 脚本做「条件跳过」或「冲突检测」，必须用 redis.pcall() 而非 redis.call()，否则某个 key 不存在导致脚本中断，后续 key 就不会被处理，造成迁移漏项。
