package util import ( "context" "fmt" "os" "time" clientv3 "go.etcd.io/etcd/client/v3" ) const ( // WorkerKeyPrefix ETCD WorkerID 注册键前缀。 WorkerKeyPrefix = "/go-sms/workers/" // workerLeaseTTL 注册租约时长;依赖 KeepAlive 自动续期, // 进程退出(client.Close)后约 TTL 内自动释放 WorkerID。 workerLeaseTTL = 60 * time.Second ) // registrar WorkerID 注册后端抽象(单测注入 mock;生产为 ETCD)。 type registrar interface { // TryCreate 尝试创建带 TTL 的键;键已存在返回 false。 TryCreate(ctx context.Context, key, value string, ttl time.Duration) (bool, error) } // AcquireWorkerID 从注册后端抢注最小的空闲 WorkerID([0, max])。 // 多副本同时启动时,ETCD 事务保证同一 ID 仅被一个持有者抢到。 func AcquireWorkerID(ctx context.Context, reg registrar, max int) (int, error) { if max < 0 || max > MaxWorkerID { max = MaxWorkerID } host, _ := os.Hostname() for id := 0; id <= max; id++ { ok, err := reg.TryCreate(ctx, fmt.Sprintf("%s%d", WorkerKeyPrefix, id), host, workerLeaseTTL) if err != nil { return 0, fmt.Errorf("util: 注册 WorkerID 失败: %w", err) } if ok { return id, nil } } return 0, fmt.Errorf("util: 无可用 WorkerID(0..%d 均被占用)", max) } // WorkerIDFromETCD 连接 ETCD 抢注 WorkerID(雪花 ID 多实例部署入口)。 // 返回的 client 由调用方持有:持有期间租约自动续期(ID 不被抢走), // 进程退出时 Close() 即释放(约 TTL 后可被其他实例复用)。 func WorkerIDFromETCD(ctx context.Context, endpoints []string) (int, *clientv3.Client, error) { cli, err := clientv3.New(clientv3.Config{ Endpoints: endpoints, DialTimeout: 5 * time.Second, }) if err != nil { return 0, nil, fmt.Errorf("util: 连接 ETCD 失败: %w", err) } id, err := AcquireWorkerID(ctx, &etcdRegistrar{client: cli}, int(MaxWorkerID)) if err != nil { _ = cli.Close() return 0, nil, err } return id, cli, nil } // etcdRegistrar 基于 ETCD 租约 + 事务的 registrar 实现。 type etcdRegistrar struct { client *clientv3.Client } // TryCreate:Grant 租约 → KeepAlive 自动续期 → Txn 仅当键不存在时写入。 func (r *etcdRegistrar) TryCreate(ctx context.Context, key, value string, ttl time.Duration) (bool, error) { lease, err := r.client.Grant(ctx, int64(ttl.Seconds())) if err != nil { return false, err } // 后台续期直至 client 关闭;消费 channel 否则续期会停滞 kach, kerr := r.client.KeepAlive(context.Background(), lease.ID) if kerr != nil { return false, kerr } go func() { for range kach { // client.Close 后 channel 关闭,goroutine 退出 } }() resp, err := r.client.Txn(ctx). If(clientv3.Compare(clientv3.CreateRevision(key), "=", 0)). Then(clientv3.OpPut(key, value, clientv3.WithLease(lease.ID))). Commit() if err != nil { return false, err } return resp.Succeeded, nil }