默认Echo中间件不支持分布式链路追踪，因其不透传trace_id/span_id、不集成OpenTracing/OpenTelemetry上下文传播；需用otelhttp.NewHandler包装Echo实例，并确保tracer初始化、出站请求用otelhttp.Client、goroutine中显式传递context。
为什么默认的 Echo 中间件不支持分布式链路追踪
因为 Echo 自带的中间件（比如 echo.MiddlewareFunc）只处理单机请求生命周期，不自动透传和生成 trace_id、span_id，也不集成 OpenTracing / OpenTelemetry 标准上下文传播逻辑。你看到的请求日志里全是孤立的 ID，服务间调用链断开，根本串不起来。
真正起作用的是标准传播协议（如 traceparent HTTP header）+ 上下文注入/提取 + tracer 实例绑定。Echo 本身不内置这些，得你自己桥接。
- 别依赖
echo.Logger或自定义Context字段模拟 trace，它无法跨 goroutine 和 HTTP client 传递 - 不要在 handler 里手动 new
span后忘记span.End()，会导致内存泄漏和 span 数据丢失 -
echo.Context不是context.Context的子类，必须显式用c.Request().Context()拿到可携带 span 的上下文
用 otelhttp + echo.WrapHandler 接入 OpenTelemetry
最轻量且兼容性最好的方式：把 Echo 的 echo.Echo 实例包装成标准 http.Handler，再用 otelhttp.NewHandler 套一层。这样所有 HTTP 入口自动注入/提取 traceparent，并生成 server span。
import (
"go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp"
"go.opentelemetry.io/otel"
)
e := echo.New()
// ……注册路由
// 包装 echo 实例为 http.Handler，并添加 OTel 中间件
httpHandler := otelhttp.NewHandler(e, "echo-server")
http.ListenAndServe(":8080", httpHandler)
- 必须在
otelhttp.NewHandler之前初始化全局 tracer provider（otel.SetTracerProvider(...)），否则 span 全部静默丢弃 -
"echo-server"是这个 service 的名称，会作为service.name写入 span，影响后端（如 Jaeger / Tempo）的服务发现 - 出站 HTTP 调用要用
otelhttp.NewClient包装过的*http.Client，否则链路在第一个外部请求就断掉
在 handler 里继续创建子 span 要用 tracer.Start() + req.Context()
HTTP server span 只覆盖到 handler 入口。数据库查询、RPC 调用、本地耗时计算等都需要自己的 span，并且要挂在当前 trace 下，否则变成孤立 span。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
func myHandler(c echo.Context) error {
ctx := c.Request().Context() // 关键：从 request 拿带 trace 的 context
tracer := otel.Tracer("my-service")
_, span := tracer.Start(ctx, "db.query")
defer span.End()
// 执行查询...
return c.String(http.StatusOK, "ok")
}
- 绝对不要用
context.Background()或context.TODO()启动 span，那会新建 trace，跟上游断开 - 如果 handler 里启动了 goroutine（比如异步发消息），必须用
trace.ContextWithSpan把 span 显式传进去，Go 的 context 不跨 goroutine 自动传播 -
span.End()必须执行，建议用defer；如果 span 被 cancel 或超时，End()仍需调用，否则 span 状态不完整
跨服务传递 trace 时注意 traceparent 的 header 名和大小写
OpenTelemetry 默认使用 traceparent（全小写），但某些旧系统或语言 SDK 可能用 Traceparent 或 TRACEPARENT。Echo 的 c.Request().Header.Get() 是大小写不敏感的，但如果你手动构造 outbound 请求，header 名写错就传不出去。
- 检查下游服务是否真的收到了
traceparent：用c.Request().Header.Get("traceparent")打日志验证 - 用
http.Header发请求时，务必写req.Header.Set("traceparent", tp)，不要写成"Traceparent"—— 尽管 Go net/http 会 normalize，但某些代理（如 Envoy）或监控 sidecar 对大小写敏感 - 如果和 Java Spring Cloud Sleuth 互通，确认双方都启用 W3C Trace Context 协议（不是 B3），否则 header 解析失败，trace_id 变成 00000000000000000000000000000000
链路追踪不是加个中间件就完事，核心在于上下文在每一个 goroutine、每一次 HTTP 调用、每一条 DB 查询中是否真实延续。漏掉任意一环，整条链就碎成几截。最常被忽略的是 outbound client 的包装和 goroutine 中的 context 传递 —— 这两处一错，90% 的 span 都对不上。
