使用Feign Client实现分布式追踪时Trace Id不一致

1. 确认依赖配置正确性 #

Spring Boot 3.x 已用Micrometer Tracing替代旧版Spring Cloud Sleuth，需确保引入对应依赖：

• Maven（pom.xml）：

<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing-bridge-brave</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-circuitbreaker-resilience4j</artifactId>
</dependency>

• Gradle：

implementation 'io.micrometer:micrometer-tracing-bridge-brave'
implementation 'org.springframework.cloud:spring-cloud-starter-openfeign'
implementation 'org.springframework.cloud:spring-cloud-starter-circuitbreaker-resilience4j'

注意：Spring Boot 3.x 要求Spring Cloud 2022.0.x（Kilburn）及以上版本，版本不匹配会直接导致追踪上下文无法传递。

2. 检查Feign上下文传递配置 #

Spring Cloud Feign引入Micrometer Tracing后会自动注册TraceFeignClientAutoConfiguration，但如果是自定义Feign配置，需手动添加追踪拦截器：

@Configuration
public class CustomFeignConfig {
    @Bean
    public Feign.Builder feignBuilder(Tracer tracer, Propagation.Factory propagationFactory) {
        return Feign.builder()
                .addRequestInterceptor(new TraceFeignRequestInterceptor(tracer, propagationFactory));
    }
}

也可直接在Feign Client接口上指定默认追踪配置：

@FeignClient(name = "service-b", configuration = TraceFeignClientAutoConfiguration.class)
public interface ServiceBClient {
    // 业务接口方法
}

3. 验证上下文传播有效性 #

在Service A调用前打印当前Trace Id：

@Autowired
private Tracer tracer;

public void invokeServiceB() {
    System.out.println("Service A Trace Id: " + tracer.currentSpan().context().traceId());
    serviceBClient.targetMethod();
}

在Service B的接口方法中打印接收的Trace Id：

@GetMapping("/target-method")
public String targetMethod() {
    System.out.println("Service B Trace Id: " + tracer.currentSpan().context().traceId());
    return "success";
}

若两者不一致，排查是否存在自定义RequestInterceptor覆盖了默认追踪拦截器，或异步调用时未用TraceableExecutorService包装线程池导致上下文丢失。

4. 排查快照版本已知问题 #

由于使用的是Spring Boot 3.0.0-Snapshot快照版本，可能存在未修复的Bug：

• 查看Spring Boot、Spring Cloud官方GitHub Issues，确认是否有Feign追踪上下文传递相关的已知问题
• 尝试升级到最新快照版本，或临时降级到Spring Boot 2.7.x稳定版本排查问题

5. 确认日志配置正确性 #

在application.yml中开启追踪日志，验证请求头是否携带traceparent：

logging:
  level:
    io.micrometer.tracing: DEBUG
    org.springframework.cloud.openfeign: DEBUG

调用时查看日志，确认Feign请求是否包含traceparent头，以及Service B是否正确解析该头。

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