如何在Golang中用go-redis执行Lua分布式锁脚本？-Redis-PHP中文网

直接用 eval 容易失败，因 go-redis 的 eval 不自动分离 keys/argv，集群下 key 未显式传入 keys 数组会触发 crossslot 错误；且每次重传脚本体，性能差、无 sha 复用，应改用 redis.script 封装后配合 evalsha 与 load。

如何在golang中用go-redis执行lua分布式锁脚本？

为什么直接用 `EVAL` 执行 Lua 锁脚本容易失败

Go-redis 的 EVAL 不自动处理键与参数分离，而 Redis Lua 脚本要求所有 key 必须显式传入 KEYS 数组，否则在集群模式下会报 CROSSSLOT Keys in request don't hash to the same slot。更关键的是，EVAL 无法复用脚本 SHA，每次执行都重新加载 Lua，性能差且易受网络抖动影响。

集群环境下必须用 EVALSHA + SCRIPT LOAD 组合，或改用 EvalSha 方法
锁脚本里不能依赖 redis.call("get", ...) 判断存在性——这会破坏原子性，应统一用 redis.call("set", ..., "NX", "PX", ...)
Go-redis v9 默认不缓存脚本 SHA，需手动管理 Script.Load 和 Script.EvalSha

用 `redis.Script` 安全封装 SETNX PX 锁逻辑

推荐把 Lua 脚本定义为全局 *redis.Script 实例，调用 Load 一次后复用 SHA。标准加锁脚本应返回 1（成功）或 0（失败），不返回 key 值——避免客户端误判。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

var lockScript = redis.NewScript(`
if redis.call("set", KEYS[1], ARGV[1], "NX", "PX", ARGV[2]) then
  return 1
else
  return 0
end
`)

// 加锁：key 是锁名，value 是唯一 client_id，expireMs 是毫秒超时
result, err := lockScript.EvalSha(ctx, rdb, []string{"my:lock:key"}, "client_abc123", "30000").Int()
if err != nil {
  // 注意：ErrNil 表示脚本未加载，需 fallback 到 Eval
  if errors.Is(err, redis.Nil) {
    result, _ = lockScript.Eval(ctx, rdb, []string{"my:lock:key"}, "client_abc123", "30000").Int()
  }
}

KEYS[1] 必须是实际锁 key，不能拼接字符串；集群中多个 key 会直接报错
ARGV[1] 推荐用随机 UUID 或进程+goroutine ID 组合，防止误删他人锁
ARGV[2] 单位是毫秒，别错写成秒——go-redis 的 time.Duration 默认纳秒，需转 int64(ms)

解锁必须用 Lua 保证原子性，且校验 value

不能用 DEL 直接删 key：可能删掉别人刚续期的锁。必须先 GET 再比对再 DEL，而这三步必须原子执行——只能靠 Lua。

var unlockScript = redis.NewScript(`
if redis.call("get", KEYS[1]) == ARGV[1] then
  return redis.call("del", KEYS[1])
else
  return 0
end
`)

_, err := unlockScript.EvalSha(ctx, rdb, []string{"my:lock:key"}, "client_abc123").Int()
// 返回 1 表示成功删除，0 表示 key 不存在或 value 不匹配