在go微服务中，需通过context.context透传traceid和spanid，并在http请求头中注入w3c标准traceparent（00-{traceid}-{spanid}-01）或统一键名如traceid；grpc使用metadata.md透传；日志需自动注入trace_id/span_id字段；必须显式调用span.end()且避免漏传上下文。
如何在 Go 微服务中注入 trace_id 和 span_id
Go 服务间 HTTP 调用默认不携带链路标识，必须手动注入。不注入就无法串联日志和指标，等于链路跟踪形同虚设。
核心是利用 context.Context 传递 trace 上下文，并在每次 HTTP 请求头中写入 trace-id 和 span-id（通常用 TraceID 和 SpanID 或 X-Trace-ID 等约定键）。OpenTracing 或 OpenTelemetry SDK 会自动处理大部分逻辑，但底层仍依赖你正确透传。
- 使用
http.Header.Set("TraceID", traceID)而非Add，避免重复写入 - 若服务同时被 gRPC 和 HTTP 调用，gRPC 需通过
metadata.MD注入，不能只处理 HTTP - 中间件中从请求头提取后，必须用
context.WithValue(ctx, key, val)存入 context，后续 handler 才能取到 - 注意 Go 的
http.Request.WithContext()是不可变操作，必须显式赋值：r = r.WithContext(newCtx)
为什么 Gin/Echo 中间件里 Span 不自动结束
常见现象：日志里看到 span started but never finished，或 Jaeger 页面显示 span 持续运行数小时。根本原因是 defer 在 panic 或 early return 时未执行，或中间件没调用 span.Finish()。
Gin/Echo 的中间件生命周期与 span 生命周期不自动对齐。SDK 不会帮你“猜”何时该结束 span，必须显式控制。
- 务必在中间件末尾或
defer中调用span.Finish()，且确保它在所有 return 路径上都执行 - 不要把
span.Finish()放在 handler 内部——中间件已开启 span，handler 只该做业务逻辑 - 如果用了
opentelemetry-go，推荐用otelhttp.NewHandler()替代手写中间件，它内置了 finish 逻辑 - 检查是否误将 span 存在局部变量而非 context，导致下游无法继承，或 finish 时 panic
跨服务调用时 trace 上下文丢失的典型场景
不是所有 HTTP 客户端都会自动传播 context，尤其是自定义 http.Client 或用了第三方库（如 resty、go-resty）时，trace 信息大概率中断。
关键点在于：HTTP client 必须从 context.Context 中读取 span 并写入 header；server 端才能从中解析并继续链路。这个过程不是 Go 默认行为。
- 原生
http.DefaultClient.Do(req)不读 context，必须用http.DefaultClient.Do(req.WithContext(ctx)) - 用
resty时需手动设置：req.SetHeader("TraceID", traceID).SetHeader("SpanID", spanID)，它不兼容 otel context - gRPC client 需用
grpc.Dial(..., grpc.WithUnaryInterceptor(otelgrpc.UnaryClientInterceptor())) - 异步任务（如发 MQ 消息）必须显式序列化当前 span 的 tracestate 到 payload，消费者再反序列化重建 context
TraceID 格式不一致导致链路断裂
不同服务用不同格式生成 trace_id（比如有的用 UUIDv4，有的用 Snowflake，有的截断为 16 字符），Jaeger 或 Zipkin 就无法识别为同一链路，搜索和图表全失效。
TraceID 是链路的唯一主键，格式错一点，整个链路就断成碎片。这不是兼容性问题，是数据一致性问题。
- 全链路必须统一使用
otel.TraceIDFromHex()或jaeger.NewTraceID()生成，禁用uuid.NewString() - HTTP header 键名要统一大写加中划线：
TraceID，而非trace_id或x-trace-id（除非全链路约定小写） - 日志打点时，别只打
trace_id字段，要确保字段名与 tracing 系统配置的 tag 名完全一致（如 Jaeger 要求trace_id小写） - 注意 Go 的
net/http对 header key 自动 title-case，TraceID会变成Traceid，建议用http.CanonicalHeaderKey("TraceID")校验
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
