redis lock

[!TIP] This document is machine-translated by Google. If you find grammatical and semantic errors, and the document description is not clear, please PR

Since it is a lock, the first function that comes to mind is: Anti-repeated clicks, only one request has an effect at a time.

Since it is redis, it must be exclusive and also have some common features of locks:

  • High performance
  • No deadlock
  • No lock failure after the node is down

In go-zero, redis set key nx can be used to ensure that the write is successful when the key does not exist. px can automatically delete the key after the timeout. "The worst case is that the key is automatically deleted after the timeout, so that there will be no death. lock"


redisLockKey := fmt.Sprintf("%v%v", redisTpl, headId)
// 1. New redislock
redisLock := redis.NewRedisLock(redisConn, redisLockKey)
// 2. Optional operation, set the redislock expiration time
if ok, err := redisLock.Acquire(); !ok || err != nil {
  return nil, errors.New("another user is currently operating, please try again later")
defer func() {

It is the same as when you use sync.Mutex. Lock and unlock, perform your business operations.

Acquire the lock

lockCommand = `if"GET", KEYS[1]) == ARGV[1] then"SET", KEYS[1], ARGV[1], "PX", ARGV[2])
    return "OK"
    return"SET", KEYS[1], ARGV[1], "NX", "PX", ARGV[2])

func (rl *RedisLock) Acquire() (bool, error) {
    seconds := atomic.LoadUint32(&rl.seconds)
  // execute luascript
    resp, err :=, []string{rl.key}, []string{, strconv.Itoa(int(seconds)*millisPerSecond + tolerance)})
    if err == red.Nil {
        return false, nil
    } else if err != nil {
        logx.Errorf("Error on acquiring lock for %s, %s", rl.key, err.Error())
        return false, err
    } else if resp == nil {
        return false, nil

    reply, ok := resp.(string)
    if ok && reply == "OK" {
        return true, nil
    } else {
        logx.Errorf("Unknown reply when acquiring lock for %s: %v", rl.key, resp)
        return false, nil

First introduce several redis command options, the following are the added options for the set command:

  • ex seconds : Set the key expiration time, in s
  • px milliseconds : set the key expiration time in milliseconds
  • nx : When the key does not exist, set the value of the key
  • xx : When the key exists, the value of the key will be set

The input parameters involved in lua script:

args example description
KEYS[1] key$20201026 redis key
ARGV[1] lmnopqrstuvwxyzABCD Unique ID: random string
ARGV[2] 30000 Set the expiration time of the lock

Then talk about the code features:

  1. The Lua script guarantees atomicity "Of course, multiple operations are implemented as one operation in Redis, that is, a single command operation"
  2. Use set key value px milliseconds nx
  3. value is unique
  4. When locking, first determine whether the value of the key is consistent with the previous setting, and modify the expiration time if it is consistent

Release lock

delCommand = `if"GET", KEYS[1]) == ARGV[1] then
    return"DEL", KEYS[1])
    return 0

func (rl *RedisLock) Release() (bool, error) {
    resp, err :=, []string{rl.key}, []string{})
    if err != nil {
        return false, err

    if reply, ok := resp.(int64); !ok {
        return false, nil
    } else {
        return reply == 1, nil

You only need to pay attention to one point when releasing the lock:

Can't release other people's locks, can't release other people's locks, can't release other people's locks

Therefore, you need to first get(key) == value「key」, and then go to delete if it is true

Copyright © 2019-2021 go-zero all right reserved,powered by GitbookLast UpdateTime: 2021-12-05 09:48:50

results matching ""

    No results matching ""