必须先设置全局传播器再初始化tracerprovider，用otelhttp.newhandler包裹http handler、otelgrpc.interceptor处理grpc、手动处理mq等非标准场景的context提取与注入，并配置parentbased采样避免孤立span。
GoLand 本身不内置全链路追踪能力，它只是个 IDE；真正实现全链路追踪得靠 Go 服务自身的埋点、OpenTelemetry SDK 集成、以及后端可观测性平台（如 Jaeger、Zipkin 或 OTLP 后端）配合。GoLand 的价值在于帮你高效写、调、查这些追踪代码，而不是自动给你加 trace。
如何在 Go 项目里正确初始化 OpenTelemetry Tracer
很多团队直接 copy 示例代码，用 otel.Tracer("service-name") 就开始打点，结果 span 全是孤立的——根本串不起来。关键不是“有没有 tracer”，而是“tracer 是否绑定到全局 propagator 且使用了正确的上下文传播器”。
- 必须显式设置全局 propagator：
otel.SetTextMapPropagator(propagation.NewCompositeTextMapPropagator(propagation.TraceContext{}, propagation.Baggage{})) - HTTP handler 必须用
otelhttp.NewHandler包裹，不能只在函数里手动 StartSpan - gRPC 客户端/服务端需分别用
otelgrpc.Interceptor()，否则跨进程链路断开 - 初始化顺序不能错：propagator → exporter → tracer provider → 全局 tracer → HTTP/gRPC 中间件
GoLand 调试时看不到 span 数据？检查这三处配置
你在 GoLand 里打断点、单步执行，但调试控制台或日志里没看到 span ID 或 trace ID，大概率不是代码问题，而是本地开发环境缺失必要链路出口。
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 确认
OTEL_EXPORTER_OTLP_ENDPOINT环境变量指向本地 Jaeger Agent（如http://localhost:4318/v1/traces），而非生产地址 - GoLand 的 Run Configuration → Environment Variables 里必须显式添加
OTEL_SERVICE_NAME=order-service，否则所有 span 默认叫 “unknown_service” - 如果用的是
stdoutexporter 调试，记得在 GoLand 的 Run Configuration → Logs → Show console when a message is printed 启用，否则输出被吞掉
电商中台常见跨服务调用场景下的 span 命名与上下文传递
订单服务调库存、再调优惠券，这三个服务 span 名都叫 “HandleOrderCreate” 就失去意义。命名要体现角色，上下文传递要防丢失。
- HTTP client 发起请求前，必须用
otelhttp.WithoutTracingHeader以外的默认行为（即自动注入traceparent），否则下游收不到 context - 异步任务（如发 Kafka 消息）需手动序列化 span context：
propagation.MapCarrier{"traceparent": ...}，再塞进消息 headers - 数据库查询建议用
go.opentelemetry.io/contrib/instrumentation/database/sql，别自己 wrapdb.Query，否则 span 不带 db.statement 属性 - span 名推荐格式：
"inventory.CheckStock"（服务.功能），避免泛泛的"HTTP GET"
电商中台里最常漏掉的是 MQ 和定时任务的 trace 注入——它们不走 HTTP/gRPC 标准传播路径，必须手动提取和注入 context，而且容易在 goroutine 启动时丢掉。GoLand 的 debugger 看不到这部分 span，得靠 Jaeger UI 实时查，别等上线才发现链路断在削峰队列里。
