Spring Boot 3.4中OpenFeign调用时Trace Context跨微服务传递问题

问题根源 #

跨服务请求Trace ID不一致，本质是OpenFeign调用时未自动传递traceparent/baggage等Trace Context信息，缺少Micrometer Tracing与OpenFeign的集成支持。

解决步骤 #

1. 补充依赖 #

添加Spring Cloud对OpenFeign的Micrometer集成支持依赖，触发Trace拦截器的自动配置：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-circuitbreaker-resilience4j</artifactId>
</dependency>

说明：现有依赖中的micrometer-tracing-bridge-otel已包含Trace核心能力，上述依赖用于激活Spring Cloud自动加载FeignTracingInterceptor，实现请求头的Trace Context注入。

2. 启用OpenFeign的Micrometer集成 #

在配置文件中开启OpenFeign的Micrometer支持：

spring:
  cloud:
    openfeign:
      micrometer:
        enabled: true

3. 验证配置生效 #

• 启动服务后，检查日志是否加载FeignTracingAutoConfiguration类
• 抓包或打印请求头，确认OpenFeign请求包含traceparent字段
• 下游服务日志的Trace ID应与上游请求的Trace ID完全一致

核心机制 #

FeignTracingInterceptor会拦截所有OpenFeign请求，将当前线程的Trace Context（由Micrometer Tracing维护）写入请求头；下游服务通过OpenTelemetry桥接组件自动解析traceparent头，复用同一个Trace ID，从而实现全链路Trace关联。

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