go-zero框架结合etcd实现节点健康检查,核心在于利用etcd的租约(lease)机制进行心跳保活。具体做法是服务启动时向etcd申请一个带ttl的租约,并在后台协程中定期续约;同时注册一个自定义的健康检查端点,该端点直接查询当前租约是否有效,若租约已过期则返回503状态码,否则返回200。

如何配置并启动基于租约的心跳保活
在Go-Zero的服务配置文件中,通过Etcd字段指定连接信息,并在代码中初始化core.EtcdHealthChecker。关键在于创建一个带有生存时间的租约,并启动一个定时器持续调用KeepAlive方法。如果续约失败或租约自然过期,etcd会自动删除对应的键值对,从而触发下游服务的发现更新。

package main
import (
"context"
"time"
"github.com/zeromicro/go-zero/core/logx"
"github.com/zeromicro/go-zero/core/service"
"go.etcd.io/etcd/client/v3"
)
// HealthChecker 封装了基于etcd租约的健康检查逻辑
type HealthChecker struct {
client *clientv3.Client
lease clientv3.LeaseID
}
func NewHealthChecker(cli *clientv3.Client) *HealthChecker {
return &HealthChecker{client: cli}
}
// StartHeartbeat 启动心跳保活
func (h *HealthChecker) StartHeartbeat(ctx context.Context, ttl int64) error {
// 1. 申请租约
grant, err := h.client.Grant(ctx, ttl)
if err != nil {
return err
}
h.lease = grant.ID
// 2. 注册服务键(可选,用于服务发现)
key := "/health/node/" + service.NodeId()
_, err = h.client.Put(ctx, key, "healthy", clientv3.WithLease(grant.ID))
if err != nil {
return err
}
// 3. 启动续约协程
go func() {
keepAliveChan := h.client.KeepAlive(ctx, grant.ID)
for {
select {
case ka := <-keepAliveChan:
if ka == nil {
logx.Error("lease keepalive lost")
return
}
case <-ctx.Done():
return
}
}
}()
return nil
}
// IsHealthy 检查当前租约是否有效
func (h *HealthChecker) IsHealthy(ctx context.Context) bool {
// 通过查看租约详情来判断是否还活着
resp, err := h.client.Lease.TimeToLive(ctx, h.lease, clientv3.WithAttachedKeys())
if err != nil {
return false
}
return resp.Granted.TTL > 0
}
如何集成到HTTP网关进行统一暴露
将上述健康检查逻辑挂载到Go-Zero的RestServer上。通常不需要修改核心的RPC逻辑,只需在HTTP层添加一个路由。当外部负载均衡器或K8s探针请求该接口时,直接调用IsHealthy方法。如果etcd租约已失效,说明节点无法维持连接,此时应返回非200状态码以剔除节点。

package main
import (
"net/http"
"github.com/zeromicro/go-zero/core/logx"
"github.com/zeromicro/go-zero/rest"
"go.etcd.io/etcd/client/v3"
)
func main() {
// 假设已经初始化了etcd客户端
etcdCli, _ := clientv3.New(clientv3.Config{
Endpoints: []string{"localhost:2379"},
})
hc := NewHealthChecker(etcdCli)
// 启动心跳,TTL设为10秒
hc.StartHeartbeat(context.Background(), 10)
s := rest.MustNewServer(rest.RestConf{})
defer s.Stop()
// 挂载健康检查接口
s.Handle(http.MethodGet, "/healthz", func(w http.ResponseWriter, r *http.Request) {
if hc.IsHealthy(r.Context()) {
w.WriteHeader(http.StatusOK)
w.Write([]byte("ok"))
} else {
w.WriteHeader(http.StatusServiceUnavailable)
w.Write([]byte("unhealthy"))
}
})
logx.Info("Starting server at :8080...")
s.Start()
}
租约过期后健康检查的具体表现是什么
当网络分区或进程卡死导致无法续约时,etcd服务器会在TTL超时后自动删除关联的Key并撤销Lease。此时,IsHealthy方法中的TimeToLive调用会返回TTL为负数或错误,导致该方法返回false。紧接着,HTTP处理器会向客户端返回503 Service Unavailable。对于依赖该接口的K8s Liveness Probe或Nginx upstream,这将立即标记该Pod或节点为不可用,从而实现故障隔离。


















