Spring Boot 3下WebClient调用服务Trace ID不一致问题求助

1. 确认依赖配置 #

确保项目依赖中包含Micrometer追踪相关组件，以Maven为例：

<dependencies>
    <!-- WebClient 基础依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-webflux</artifactId>
    </dependency>
    <!-- Micrometer 核心追踪API -->
    <dependency>
        <groupId>io.micrometer</groupId>
        <artifactId>micrometer-tracing</artifactId>
    </dependency>
    <!-- Brave桥接层（也可替换为opentelemetry实现） -->
    <dependency>
        <groupId>io.micrometer</groupId>
        <artifactId>micrometer-tracing-bridge-brave</artifactId>
    </dependency>
</dependencies>

2. 为WebClient添加追踪过滤器 #

在构建WebClient Bean时，注入TracingExchangeFilterFunction，该过滤器会自动将当前请求的Trace上下文（Trace ID、Span ID）通过HTTP头传递给下游服务：

import io.micrometer.tracing.Tracer;
import io.micrometer.tracing.web.reactive.client.TracingExchangeFilterFunction;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.reactive.function.client.WebClient;

@Configuration
public class WebClientConfig {

    @Bean
    public WebClient webClient(Tracer tracer) {
        TracingExchangeFilterFunction tracingFilter = new TracingExchangeFilterFunction(tracer);
        return WebClient.builder()
                .filter(tracingFilter)
                .build();
    }
}

3. 下游服务配置验证 #

子微服务只需同样配置上述Micrometer追踪依赖，Spring Boot会自动解析传入的traceparent等HTTP头，继承父服务的Trace ID，无需额外代码配置。

4. 日志验证Trace ID一致性 #

在application.properties中配置日志格式，打印Trace ID方便验证：

logging.pattern.level=%5p [${spring.application.name:},%X{traceId:-},%X{spanId:-}]

调用父服务接口后，查看父、子服务的日志，确认两者的traceId字段值完全一致。

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