可行但需手动配置租约与心跳,设DialTimeout≥3s、DialKeepAliveTime=10s,注册时必须传LeaseID(推荐嵌入ServiceInstance.ID),Watch需监听Done()并重试。

直接用 etcd 做 Kratos 的注册中心是可行的,但默认不启用健康检查自动摘除,必须手动配租约(lease)和心跳续期,否则服务宕机后实例会一直“挂着”。
etcd 客户端初始化必须显式设置 DialTimeout 和 DialKeepAliveTime
Kratos 的 etcd/v2 注册插件底层用的是 go.etcd.io/etcd/client/v3,但没封装连接保活逻辑。如果网络抖动或 etcd 重启,客户端可能卡在阻塞读里,导致服务注册失败或 Watch 中断。
-
DialTimeout至少设为3s,避免 DNS 解析慢拖垮启动 -
DialKeepAliveTime推荐10s,配合 etcd server 端的keepalive-minimum-grace-time - 别依赖默认配置——
client/v3默认DialTimeout=0(无限等待)
示例:
client, err := etcdclient.New(etcdclient.Config{
Endpoints: []string{"http://127.0.0.1:2379"},
DialTimeout: 3 * time.Second,
DialKeepAliveTime: 10 * time.Second,
})
if err != nil {
log.Fatal(err)
}
reg := etcdregitry.New(client)
Register 必须传入带 Lease ID 的 ServiceInstance
etcd 本身不提供主动健康探测,Kratos 的 etcdregitry 依赖租约(lease)实现 TTL 自动过期。如果不传 LeaseID,注册进去的服务实例永不超时,Deregister 也无效。
-
ServiceInstance.Metadata里不能放lease字段——它被忽略 - 正确做法:调用
client.Grant(ctx, ttl)拿到LeaseID,再塞进ServiceInstance.ID或单独存字段(推荐存进ID,因为etcdregitry内部只认这个) - TTL 建议 ≥ 15s,太短容易因 GC 或调度延迟误删
关键代码片段:
leaseResp, _ := client.Grant(context.Background(), 20)
svc := ®istry.ServiceInstance{
ID: fmt.Sprintf("helloworld-%d", os.Getpid()),
Name: "helloworld",
Version: "v1.0.0",
Endpoints: []string{"grpc://127.0.0.1:9000"},
}
// 注意:etcdregitry 用 ID 当 lease key,所以得把 lease ID 绑定过去
// 实际项目中建议封装成函数统一处理
_, _ = client.Put(context.Background(), "/registry/"+svc.ID, "", client.WithLease(leaseResp.ID))
Watch 服务列表时需自己处理连接断开重试
etcdregitry.Watch 返回的 Watcher 在 etcd 连接中断后不会自动重连,也不会抛错,而是静默停止发送事件。这是最常被忽略的坑。
- 不能只写一次
for range watcher.EventChan()就完事 - 必须监听
watcher.Done(),并在关闭后重建client.Watch并重新调用etcdregitry.Watch - 首次 Watch 建议加
WithRev(0)获取全量快照,避免漏掉已注册服务
简单重试逻辑示意:
func watchSvc(name string) {
for {
watcher, err := reg.Watch(context.Background(), name)
if err != nil {
time.Sleep(time.Second)
continue
}
for {
select {
case ev := <p>etcd 集成不是“连上就行”,租约生命周期、Watch 断连恢复、客户端连接参数这三点不细调,上线后大概率出现服务发现失灵或僵尸实例堆积。尤其在 K8s 环境下,Pod 频繁重建会让 lease 管理更敏感——别跳过手动续期或封装 lease 池。 </p>











