gRPC跨机房调用需配置keepalive保活、显式超时控制、自定义DNS解析及HTTP/2流控调优，否则空闲断连、DNS缓存、流控阻塞等会导致150–300ms延迟毛刺。
跨服务调用在 Go 微服务中不是“能通就行”的问题——延迟毛刺、P99 突增、goroutine 数暴涨，往往都源于调用链路上几个可预见但常被忽略的细节。直接换 gRPC 或加个连接池不能根治，得看清楚每层到底在做什么。
gRPC 客户端连接复用必须显式配置
Go 的 grpc.Dial 默认不复用连接，每次调用新建 ClientConn 会导致 TCP 握手、TLS 协商、DNS 解析重复发生，尤其在短生命周期服务（如 Lambda 风格函数）里开销极明显。
- 必须传入
grpc.WithTransportCredentials或grpc.WithInsecure()，否则连接会 fallback 到非复用模式 - 启用 keepalive：用
grpc.WithKeepaliveParams设置time.Second * 30心跳间隔和time.Second * 10timeout，防连接被中间设备（NAT/防火墙）静默断开 - 禁用默认的
grpc.WithBlock()，改用带超时的 context 控制阻塞等待，避免 goroutine 卡死在连接建立阶段 - 连接池不是自动的——多个业务模块共用同一
*grpc.ClientConn实例，而不是各自 dial
Protobuf 编解码性能陷阱：别让 Marshal/Unmarshal 成瓶颈
Protobuf 虽比 JSON 快，但 proto.Marshal 和 proto.Unmarshal 仍占 gRPC 调用耗时 15–30%，尤其在高频小消息场景下。
- 避免在 hot path 上反复 new message struct；用
sync.Pool缓存*pb.Request/*pb.Response实例 - 字段命名和编号影响序列化效率：不要跳号（如只用 1、2、100），protobuf 会填充稀疏空间；布尔字段优先用
bool而非int32编码 - 对大 payload（>1MB），考虑启用 gRPC 流式接口 + 分块传输，避免单次编解码阻塞整个 goroutine
- 调试时用
go tool pprof -http=:8080 your_binary抓 CPU profile，确认proto.(*Buffer).Encode*是否出现在火焰图顶部
上下文传播必须穿透所有中间件
TraceID 和 span context 如果在某一层 middleware（比如 auth、rate limit）里没被正确 Extract 和 Inject，整条链路就断了——你看到的只是孤立的 Span，不是 Trace。
- HTTP 场景下，确保所有中间件读取并透传
traceparent和tracestate头（W3C 标准），不只是自定义X-Trace-ID - gRPC 场景下，必须用
otel.GetTextMapPropagator().Inject()写入metadata.MD，再通过metadata.NewOutgoingContext()传递，不能只靠context.WithValue - 日志打点时，务必从 context 提取
trace.SpanFromContext(ctx)获取当前 span，而非新建；否则日志和 trace 不关联 - 第三方库（如
database/sql、redis）需手动注入 context，它们默认不参与 trace propagation
服务发现与健康检查的反模式
注册中心（etcd/Consul）本身不是瓶颈，但客户端轮询方式和缓存策略不当，会让服务发现变成调用链第一跳的延迟源。
- 别用长轮询（long-polling）拉取服务列表——它本质是阻塞 HTTP 请求，goroutine 积压；改用 watch 机制监听变更事件
- 本地缓存必须带 TTL（如 30s），且配合主动探活：对每个 endpoint 发起轻量
/health探针，失败则剔除缓存，避免“僵尸地址”持续被路由 - 客户端负载均衡（如
grpc.RoundRobin）依赖 DNS 或 resolver 返回的地址列表；如果 resolver 没实现故障转移（fallback），一个实例挂掉就会导致部分请求失败 - Kubernetes 环境下，优先用 headless Service + Endpoints 直接解析，绕过 kube-proxy，减少 iptables 规则匹配开销
真正卡住跨服务调用的，往往不是协议或语言本身，而是连接怎么建、上下文怎么传、地址怎么查这三个动作里夹杂的隐式假设。每个环节都得拿 pprof 和 tcpdump 验证，而不是靠文档推测。
