微服务必须实现带健康检查的服务注册与发现、gRPC连接池与重试、按服务维度的熔断、全链路traceID日志与指标。注册需心跳保活并校验依赖；gRPC需显式配置连接参数与错误码重试；熔断须嵌入客户端并统一错误类型；日志指标须透传traceID并跨goroutine携带。
服务注册与发现必须带健康检查
只把服务地址写死进配置或靠 DNS 轮询，等同于放弃高可用。Golang 微服务启动后必须主动向注册中心（如 etcd、consul 或 nacos）注册，并持续上报健康状态。
关键点在于：注册时不能只发一次，得用 KeepAlive 或定时心跳；健康检查接口（如 /health）要真实反映服务状态——不能只返回 200，得校验数据库连接、缓存连通性、关键 goroutine 是否卡住。
- 用
grpc-go时，别依赖默认的Resolver，需自定义并集成consulapi或clientv3实现带 TTL 的注册 -
etcd注册建议用Lease绑定 key，避免服务宕机后残留脏数据 - 健康检查响应体里最好包含时间戳和关键依赖延迟（如
"db_ping_ms": 12），方便监控告警联动
gRPC 连接池与重试策略不能靠默认值
Go 默认的 grpc.Dial 不带连接池复用逻辑，也不自动重试失败请求。生产环境直接用 grpc.WithTransportCredentials 加个 TLS 就跑，很容易在下游抖动时雪崩。
必须显式控制连接生命周期和失败行为：
立即学习“go语言免费学习笔记（深入）”；
- 用
grpc.WithBlock()+grpc.FailOnNonTempDialError(true)避免 Dial 返回假成功 - 设置
grpc.WithConnectParams(grpc.ConnectParams{MinConnectTimeout: 5 * time.Second})防止快速重连压垮注册中心 - 重试需按错误码区分：
codes.Unavailable可重试，codes.InvalidArgument绝对不能重试；推荐用grpc_retry库配WithPerRetryTimeout(2 * time.Second)
熔断器要嵌入业务调用链而非仅放在网关层
只在 API 网关（如 kratos 或 go-zero 的 gateway）做熔断，对内部服务间调用无效。Golang 微服务之间直连 gRPC 时，每个 client 实例都应自带熔断逻辑。
推荐用 sony/gobreaker，但注意它不感知 gRPC 状态码，需手动包装：
cb := gobreaker.NewCircuitBreaker(gobreaker.Settings{
Name: "user-service-client",
MaxRequests: 10,
Timeout: 30 * time.Second,
ReadyToTrip: func(counts gobreaker.Counts) bool {
return counts.TotalFailures > 3 && float64(counts.TotalFailures)/float64(counts.Requests) > 0.6
},
})
- 熔断触发后，
cb.Execute返回的 error 必须是gobreaker.ErrOpenState，否则上层 gRPC middleware 无法统一拦截转成codes.Unavailable - 不要为每个 RPC 方法建独立熔断器，按下游服务维度聚合（如所有对
order-svc的调用共用一个cb） - 熔断恢复期（
Timeout）建议设为 30–60 秒，太短易反复震荡，太长影响故障恢复速度
日志与指标必须绑定 traceID 且可跨服务串联
没有 traceID 的日志等于盲人摸象。Golang 微服务一旦拆分，单靠 log.Printf 或 zap 打印时间戳，根本没法定位一次请求在哪条链路上卡住或失败。
必须在入口（HTTP handler / gRPC interceptor）提取或生成 traceID，并透传到所有下游调用和日志上下文：
- HTTP 请求优先从
X-Trace-IDheader 读，不存在则用uuid.NewString()生成；gRPC 用metadata.MD透传 - 所有日志语句必须通过
logger.With(zap.String("trace_id", traceID))构造子 logger，禁止拼接字符串 - 指标打点（如
prometheus.CounterVec）也要带trace_idlabel —— 表面看冗余，实则排查慢请求时能直接关联到具体 trace
最常被忽略的是 context 跨 goroutine 传递：起新 goroutine 前务必用 context.WithValue(ctx, key, val) 显式携带 traceID，否则子协程日志就断联了。
