Spring Boot 3中RestClient无法传递Trace ID问题求助

问题原因 #

RestTemplate默认通过自动配置的TraceRestTemplateInterceptor实现Trace ID的HTTP头传递，但RestClient作为Spring 6引入的新客户端API，默认未启用链路追踪上下文传递机制，导致跨服务调用时无法将当前请求的Trace ID传递给下游服务。

解决方案 #

1. 确保依赖配置正确 #

首先确认项目中引入了Micrometer Tracing相关依赖（Spring Boot 3已替换原Spring Cloud Sleuth），以Maven为例，在pom.xml中添加：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing-bridge-brave</artifactId>
</dependency>
<!-- 可选：若需要通过Actuator查看链路追踪端点 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>

2. 修改RestClient配置，启用链路追踪上下文传递 #

在RestClientConfig中，构建RestClient时启用Observation支持（Micrometer Tracing基于Observation实现上下文传递），修改后的代码如下：

import io.micrometer.observation.ObservationRegistry;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.client.RestClient;
import org.springframework.web.client.support.RestClientAdapter;
import org.springframework.web.service.invoker.HttpServiceProxyFactory;

import com.example.clients.BeClient;

@Configuration
public class RestClientConfig {

    @Value("${api.url}")
    private String apiUrl;

    private final ObservationRegistry observationRegistry;

    // 注入Spring自动配置的ObservationRegistry
    public RestClientConfig(ObservationRegistry observationRegistry) {
        this.observationRegistry = observationRegistry;
    }

    @Bean
    public BeClient beClient() {
        RestClient restClient = RestClient.builder()
                .baseUrl(apiUrl)
                .observationEnabled(true) // 启用Observation，自动传递Trace ID上下文
                .observationRegistry(observationRegistry)
                .build();
        
        var restClientAdapter = RestClientAdapter.create(restClient);
        var httpServiceProxyFactory = HttpServiceProxyFactory.builderFor(restClientAdapter).build();
        
        return httpServiceProxyFactory.createClient(BeClient.class);
    }
}

3. 验证下游服务配置 #

确保BE服务同样配置了Micrometer Tracing依赖与日志格式，能正确解析上游传递的traceparent等链路追踪HTTP头，生成一致的Trace ID。

原理说明 #

启用observationEnabled(true)后，RestClient会自动添加ObservationClientHttpRequestInterceptor拦截器，该拦截器会将当前线程上下文的Trace ID封装到HTTP请求头中（如traceparent），下游服务接收请求后，会解析该头信息并沿用相同的Trace ID，从而实现端到端的链路追踪一致性。

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