echootel.Middleware必须作为第一个Use()调用，且service name不能为空字符串；跨goroutine和DB操作需显式传递context；TracerProvider须全局唯一早注册并配置采样器。
echootel.Middleware必须放在最外层，不能套在自定义中间件里
Echo 的 echootel.Middleware 不是普通中间件，它依赖于 Echo 的 echo.HTTPErrorHandler 和底层 echo.Context 生命周期来正确结束 span。一旦被包裹在自定义中间件（比如日志、鉴权）之后，span 的结束时机就错乱了：可能提前结束（写响应前）、可能永不结束（panic 后 defer 没执行），导致 Jaeger 里看到大量 incomplete span 或 missing traceparent。
常见错误写法：r.Use(myAuthMiddleware, echootel.Middleware("my-service")) —— 这会让 span name 固定为 GET /，丢失真实路由路径（如 GET /users/:id）。
正确顺序只有一种：r.Use(echootel.Middleware("my-service")) 必须是第一个 Use() 调用，后续中间件都得排在它后面。
span name 为空字符串会导致 Jaeger 静默丢弃整个 span
echootel.Middleware 第二个参数是 service name，不是 span name；它最终生成的 span name 来自 Echo 的路由匹配结果（如 GET /users/:id）。但如果你传了空字符串 ""，Jaeger 等后端会直接跳过该 span——不报错、不警告、UI 里完全看不到，只留下一个“链路消失”的假象。
务必确保非空：echootel.Middleware("user-api")，且该字符串应与 resource.NewWithAttributes(semconv.ServiceNameKey.String("user-api")) 中的服务名一致，否则跨服务链路无法关联。
其他易踩点：
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 没调
otel.SetTextMapPropagator(propagation.TraceContext{})：跨服务调用时traceparentheader 不会被注入或解析，下游收不到 parent context - 用了
echo.WrapHandler(otelhttp.NewHandler(...))：这是反模式，echootel.Middleware已内部封装了otelhttp的逻辑，重复包裹会破坏 context 传播
goroutine 和 DB 查询必须显式传 ctx，否则链路在第一跳就断
Echo handler 内启动的新 goroutine（比如异步发消息、定时清理）默认拿不到 span context，trace.SpanFromContext(c.Request().Context()) 返回 nil。Go 的 context.Context 不跨 goroutine 自动继承，这是语言层事实，不是配置问题。
正确做法是：在 handler 里用 ctx := c.Request().Context() 获取带 span 的 context，再传给 goroutine：go doAsyncWork(ctx)；函数内必须用 trace.SpanFromContext(ctx) 获取 parent span 并 StartChild。
数据库同理：db.QueryContext(c.Request().Context(), query)，不能用 db.Query()；GORM 要用 db.WithContext(c.Request().Context()).Find(&u)。否则 SQL span 会变成 root，和 HTTP span 完全脱节。
TracerProvider 必须全局唯一且早注册，否则所有 span 都是 nil
otel.Tracer("xxx") 返回的 tracer 如果背后没有有效的 sdktrace.TracerProvider，就会返回一个“空 tracer”——所有 Start() 调用都静默返回 nil span，HTTP handler 不生成 server span，日志里也看不到 trace_id，但程序完全不 panic、不报错。
初始化必须在 main() 开头做，且只做一次：tp := sdktrace.NewTracerProvider(...)，然后立刻 otel.SetTracerProvider(tp) 和 otel.SetTextMapPropagator(...)。别放 init()，单元测试并发跑会 panic；别在 handler 里 new，会导致采样器冲突、exporter 连接泄漏。
采样器必须显式配，sdktrace.NeverSample() 是默认行为——不是“低采样”，是彻底不生成任何 span。生产建议用 sdktrace.ParentBased(sdktrace.TraceIDRatioBased(0.01))，避免上游不采样导致整条链路消失。
