Quarkus 2.13.x中OpenTelemetry自动上下文传播失效问题咨询

针对你遇到的问题，结合Quarkus 2.13.x的OpenTelemetry实现特性，可从以下几个方向排查和修复：

• 确认依赖的正确性
  你引入的io.opentelemetry:opentelemetry-extension-trace-propagators属于原生OpenTelemetry扩展，而Quarkus的quarkus-opentelemetry扩展已经内置了所需的传播器实现，额外引入可能导致版本冲突。建议移除这个依赖，仅保留Quarkus官方的OpenTelemetry依赖：

  implementation 'io.quarkus:quarkus-opentelemetry'
  

• 检查HTTP客户端的自动Instrumentation支持
  自动上下文传播依赖于Quarkus对HTTP客户端的自动增强，如果你使用的是JAX-RS Client或RestEasy Reactive Client，确保已经引入对应的Quarkus扩展：

  • 对于JAX-RS Client：

    implementation 'io.quarkus:quarkus-rest-client'
    

  • 对于RestEasy Reactive Client：

    implementation 'io.quarkus:quarkus-rest-client-reactive'
    

  如果你使用的是其他HTTP客户端（如OkHttp、Apache HttpClient），需要额外添加对应的OpenTelemetry Instrumentation依赖，以Quarkus适配的版本为准，比如：

  implementation 'io.opentelemetry.instrumentation:opentelemetry-okhttp-3.0'
  

• 排查异步线程的上下文传递
  如果跨服务调用是在异步线程中执行的，确保使用Quarkus提供的ManagedExecutor来提交任务，而不是直接创建线程或使用普通的ExecutorService。原生线程池不会自动传播OpenTelemetry上下文，示例代码：

  @Inject
  ManagedExecutor managedExecutor;
  
  public void asyncCall() {
      managedExecutor.submit(() -> {
          // 这里的跨服务调用会自动传播上下文
          restClient.callOtherService();
      });
  }
  

• 验证请求头是否被篡改
  检查应用中是否存在自定义的Filter、Interceptor或网关层逻辑，是否无意中移除了链路追踪相关的请求头（如traceparent、jaeger-trace-id、jaeger-span-id等）。这些头是上下文传播的载体，被移除会导致自动传播失效。

• 确认配置的生效性
  你的quarkus.opentelemetry.propagators=tracecontext,baggage,jaeger配置在Quarkus 2.13.x中是有效的，但可以添加日志配置来验证传播器是否正确加载：

  quarkus.log.category."io.quarkus.opentelemetry".level=DEBUG
  

  启动应用后查看日志，确认是否输出了传播器初始化的相关信息，比如加载了TraceContextPropagator、JaegerPropagator等。

• 检查服务间调用的协议
  确保跨服务调用使用的是HTTP/HTTPS协议，Quarkus OpenTelemetry的自动传播目前主要支持HTTP请求的上下文传递。如果使用的是其他协议（如gRPC），需要额外配置对应的Instrumentation扩展。

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