Feature mutex

utils/mutex.go

@@ -0,0 +1,112 @@
+package utils
+
+import (
+	"context"
+	"errors"
+	"time"
+
+	"github.com/google/uuid"
+	"github.com/redis/go-redis/v9"
+)
+
+// DistributedMutex 分布式锁
+type DistributedMutex interface {
+	// Lock 获取锁
+	Lock(ctx context.Context) (bool, error)
+	// TryLock 尝试获取锁
+	TryLock(ctx context.Context, attempts int, delay time.Duration) (bool, error)
+	// UnLock 释放锁
+	UnLock(ctx context.Context) error
+}
+
+// redisMutex 基于「Redis」实现的分布式锁
+type redisMutex struct {
+	cli    *redis.Client
+	key    string
+	token  string
+	expire time.Duration
+}
+
+func (m *redisMutex) Lock(ctx context.Context) (bool, error) {
+	select {
+	case <-ctx.Done(): // timeout or canceled
+		return false, ctx.Err()
+	default:
+	}
+
+	if err := m.lock(ctx); err != nil {
+		return false, err
+	}
+	return len(m.token) != 0, nil
+}
+
+func (m *redisMutex) TryLock(ctx context.Context, attempts int, interval time.Duration) (bool, error) {
+	for i := 0; i < attempts; i++ {
+		select {
+		case <-ctx.Done(): // timeout or canceled
+			return false, ctx.Err()
+		default:
+		}
+
+		// attempt to acquire lock
+		if err := m.lock(ctx); err != nil {
+			return false, err
+		}
+		if len(m.token) != 0 {
+			return true, nil
+		}
+		time.Sleep(interval)
+	}
+	return false, nil
+}
+
+func (m *redisMutex) UnLock(ctx context.Context) error {
+	if len(m.token) == 0 {
+		return nil
+	}
+
+	script := `
+if redis.call('get', KEYS[1]) == ARGV[1] then
+	return redis.call('del', KEYS[1])
+else
+	return 0
+end
+`
+	return m.cli.Eval(context.WithoutCancel(ctx), script, []string{m.key}, m.token).Err()
+}
+
+func (m *redisMutex) lock(ctx context.Context) error {
+	token := uuid.New().String()
+	ok, err := m.cli.SetNX(ctx, m.key, token, m.expire).Result()
+	if err != nil {
+		// 尝试GET一次：避免因redis网络错误导致误加锁
+		v, _err := m.cli.Get(ctx, m.key).Result()
+		if _err != nil {
+			if errors.Is(_err, redis.Nil) {
+				return err
+			}
+			return _err
+		}
+		if v == token {
+			m.token = token
+		}
+		return nil
+	}
+	if ok {
+		m.token = token
+	}
+	return nil
+}
+
+// RedisMutex 基于Redis实现的分布式锁实例
+func RedisMutex(cli *redis.Client, key string, ttl time.Duration) DistributedMutex {
+	mutex := &redisMutex{
+		cli:    cli,
+		key:    key,
+		expire: ttl,
+	}
+	if mutex.expire == 0 {
+		mutex.expire = time.Second * 10
+	}
+	return mutex
+}