无法通过Golang otel HTTP客户端实现B3头向下游服务传播

• 确认B3 Propagator注册状态
  OpenTelemetry默认不会启用B3传播机制，必须显式注册。检查代码中是否添加了以下配置：

  import (
    "go.opentelemetry.io/contrib/propagators/b3"
    "go.opentelemetry.io/otel"
  )
  
  func init() {
    // 注册B3 propagator，兼容单头/多头两种格式
    otel.SetTextMapPropagator(b3.New())
  }
  

  若需同时支持多种传播格式，可使用composite.CompositeTextMapPropagator组合多个propagator。

• 检查HTTP客户端上下文传递
  使用OpenTelemetry HTTP包装器时，必须将包含追踪信息的上下文传入请求。调用下游服务时确保代码类似：

  client := otelhttp.DefaultClient
  req, err := http.NewRequest("GET", downstreamURL, nil)
  if err != nil {
    // 错误处理逻辑
  }
  // 传递当前上下文，确保追踪头被注入请求头
  resp, err := client.Do(req.WithContext(ctx))
  

  核对示例中backend.go的HTTP客户端是否正确传递了带追踪上下文的请求。

• 验证B3头格式合法性
  B3头分两种格式：单头格式（b3: traceId-spanId-sampled）和多头格式（X-B3-TraceId/X-B3-SpanId/X-B3-Sampled）。确认cURL请求头格式正确，例如：

  curl -H "X-B3-TraceId: 463ac35c9f6413ad48485a3953bb6124" \
       -H "X-B3-SpanId: 0021683323b1e250" \
       -H "X-B3-Sampled: 1" \
       http://目标服务地址
  

• 排查中间件对请求头的影响
  确认服务中其他HTTP中间件未移除或修改B3相关请求头，部分日志、安全中间件可能过滤请求头，需保证B3头能完整传递至OpenTelemetry处理逻辑。

• 启用调试日志定位问题
  开启OpenTelemetry调试日志，查看追踪头的注入/提取细节：

  import "go.opentelemetry.io/otel/sdk/log"
  
  logger := log.NewLogger(
    log.WithProcessor(log.NewSimpleProcessor(os.Stdout)),
    log.WithResource(resource.NewWithAttributes(
      semconv.SchemaURL,
      semconv.ServiceName("你的服务名"),
    )),
  )
  otel.SetLogger(logger)
  

  通过日志确认追踪头是否被正确处理。

内容的提问来源于stack exchange，提问作者Rogier Lommers