单靠日志或单服务监控无法定位跨服务延迟，必须用 opentelemetry + jaeger 做全链路追踪，并配合 pprof 和 trace 分层协作：链路追踪定位慢跳，pprof 分析 cpu 热点，trace 诊断 goroutine 阻塞与 gc 问题。
直接说结论：单靠日志或单服务监控永远定位不了跨服务延迟，必须用 OpenTelemetry + Jaeger（或 Zipkin）做全链路追踪，再配合 pprof 和 trace 定位单节点瓶颈。三者不是替代关系，而是分层协作——链路追踪告诉你“哪一跳慢”，pprof 告诉你“这个服务里哪个函数吃 CPU”，trace 告诉你“这次请求里 Goroutine 是卡在 syscall 还是被 GC 抢占了”。
为什么 trace_id 透传失败会导致链路断裂
链路断裂不是 Jaeger 界面没数据，而是 Span 显示为孤立节点、Parent-SpanId 为空、TraceId 在服务间不一致。根本原因在于上下文未正确传递。
-
http.Request.Context()是唯一可信的传播载体，手动拼接 header（如r.Header.Set("X-Trace-ID", ...)）会丢失 Span 状态和采样决策 - gRPC 场景下必须用
grpc.WithUnaryInterceptor+otelgrpc.UnaryClientInterceptor，裸调metadata.AppendToOutgoingContext只传 ID 不传 SpanContext，下游无法续接 - Go 的
context.WithValue不跨 goroutine 生效，若你在 handler 里启了新 goroutine 处理异步逻辑（比如发 MQ），必须显式用ctx = context.WithValue(parentCtx, key, val)再传入，否则该 goroutine 的 Span 会新建 TraceId - 第三方库（如
database/sql、redis-go）需接入otelinstrumentation包，否则 DB 查询、Redis 调用不会自动创建子 Span——不是漏埋点，是根本没启用插件
pprof 分析时 cpu profile 没热点？先看 goroutine 状态
很多团队跑完 go tool pprof http://localhost:6060/debug/pprof/profile?seconds=30 发现 top 函数全是 runtime.mcall 或 runtime.gopark，说明 CPU 并不忙，问题出在阻塞。
- 立刻访问
http://localhost:6060/debug/pprof/goroutine?debug=2，搜索chan receive、semacquire、select等关键词，看是否有成百上千 goroutine 卡在同一行 - 典型泄漏场景：
http.Client未设Timeout或Transport.IdleConnTimeout，导致连接池耗尽后所有请求排队等待空闲连接 - 数据库层常见卡点：
db.QueryRow返回sql.ErrNoRows后没 closerows，或事务开启后忘记tx.Commit()/tx.Rollback()，连接一直被占用 - 别只盯着
top，用go tool pprof进入交互后执行web，图中红色粗线指向的函数如果状态是IO wait，就说明它在等下游响应，此时该去查链路追踪而非优化本函数
trace 工具里看到 GC STW 时间长，但 heap profile 显示内存不高
这说明不是内存泄漏，而是分配模式触发了高频 GC。Go 的 GC 触发阈值由堆增长量决定，不是绝对大小。
- 检查
GOGC环境变量是否被设为极低值（如GOGC=10），这会让 GC 每次堆增长 10% 就触发，STW 频率飙升 - 用
go tool pprof http://localhost:6060/debug/pprof/heap查inuse_space和alloc_space，若后者远大于前者（比如 alloc=500MB，inuse=50MB），说明对象生命周期短、分配频繁——重点排查循环内fmt.Sprintf、strings.ReplaceAll、构造临时 struct/slice -
go tool trace trace.out中点击 “Goroutines” 标签页，筛选状态为GC assist的 Goroutine，若大量出现，证明 mutator 正在帮 GC 标记对象，这是分配过载的明确信号 - 避免在 hot path 中使用
reflect或encoding/json.Marshal，它们会触发大量小对象分配；gRPC 场景优先用 Protobuf 原生序列化，而非 JSON 中转
链路追踪不是加个 SDK 就完事，真正难的是让每个服务都严格遵循上下文传递契约；pprof 和 trace 也不是命令跑对就行，关键在理解每类 profile 对应的真实运行态。最常被忽略的一点：所有分析必须在相同流量特征下做——压测流量和真实用户流量的 goroutine 行为可能完全不同，别用测试环境的 trace 结果去推断线上问题。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
