Go语言服务注册发现教程详解

本文深入剖析了Go语言中服务注册与发现的核心实践难点与避坑指南，聚焦etcd租约心跳续期、Consul健康检查配置、DNS SRV解析限制以及服务下线兜底机制四大关键场景，直击“幽灵服务”“查询不到”“注册失效”等生产环境高频问题，强调注册不是终点而是闭环起点——唯有确保注册、心跳、下线、查询在网络分区、进程强杀、时钟漂移等异常下仍语义一致，才能构建真正可靠的服务发现体系。

服务注册时为什么 etcd 的 Put 要带租约（lease）

不带租约的注册是“一锤子买卖”，进程挂了也不会自动清理，其他服务会一直以为它还活着。用 etcd 做服务发现，必须靠租约实现心跳续期和自动过期。

• Put 时必须传入 lease.ID，否则注册条目永不过期
• 租约 TTL 通常设为 5–15 秒，太短增加 etcd 压力，太长导致故障感知延迟
• 得另起 goroutine 定期调用 Lease.KeepAlive，不能只靠一次 Put
• 如果 KeepAlive 返回 error（比如连接断开），要主动重连并重建租约，否则下次心跳就失败

用 consul 的 Agent.ServiceRegister 注册后查不到服务

Consul 默认只在本地 agent 上注册，且需要手动触发健康检查，不是写完就立刻可发现。

• 确保 Address 字段填的是其他服务能访问到的 IP，不是 127.0.0.1 或 localhost
• 必须设置 Check 字段（哪怕只是个 TTL 检查），否则 Consul 认为服务“不健康”，不会返回给 Health.Service 查询
• 注册后需等至少一个检查周期（如 TTL=30s 就要等 30s）才进入 passing 状态
• 查询时别只用 Health.Service("xxx")，加 PassingOnly: true 参数，否则可能拿到已失效的服务实例

客户端做服务发现时，srv, err := net.LookupSRV 总是返回空

DNS SRV 是轻量方案，但依赖 DNS 配置正确，Go 标准库不做兜底重试或 fallback，出错就静默失败。

• 域名必须带完整服务名和协议，例如 "_http._tcp.example.com"，少下划线或协议名会直接返回 err != nil
• 本地 DNS 解析器（如 /etc/resolv.conf）必须能访问到配置了 SRV 记录的 DNS 服务器，公共 DNS（如 8.8.8.8）通常不支持自定义 SRV
• net.LookupSRV 不走 HTTP，也不读环境变量或配置文件，纯 DNS 查询，调试时可用 dig SRV _http._tcp.example.com 先验证
• 没有 fallback 机制：查不到就真的没服务，不会自动切到本地配置或 etcd

服务下线时忘记调用 etcd 的 Delete 或 consul 的 Agent.ServiceDeregister

进程被 kill -9、OOM 或 panic 退出时，没机会执行清理代码，残留注册信息会卡住好几分钟甚至更久。

• etcd 租约到期后自动删 key，但依赖 KeepAlive 正常工作；一旦网络抖动或 goroutine 崩溃，租约就失效，服务“幽灵存活”
• Consul 提供 DeregisterCriticalServiceAfter 配置项，建议设为 "90s"，比健康检查间隔长一点，作为兜底
• Go 程序应监听 os.Interrupt 和 syscall.SIGTERM，在 defer 或 signal.Notify 回调里做显式注销
• 别依赖 defer 清理网络资源——goroutine panic 或 OS 强杀时，defer 不保证执行

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~