SpringBoot 3迁移：RestTemplate如何适配Micrometer Tracing实现链路ID传递？

1. 先确认依赖配置 #

确保项目引入Micrometer Tracing核心依赖及对应的Tracer实现（以常用的Brave为例），Maven配置示例：

<dependencies>
    <!-- 监控基础依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <!-- Micrometer Tracing核心包 -->
    <dependency>
        <groupId>io.micrometer</groupId>
        <artifactId>micrometer-tracing</artifactId>
    </dependency>
    <!-- Brave作为Tracer实现 -->
    <dependency>
        <groupId>io.micrometer</groupId>
        <artifactId>micrometer-tracing-bridge-brave</artifactId>
    </dependency>
</dependencies>

2. 推荐：使用自动配置（最省心） #

Spring Boot 3 + Micrometer Tracing已内置自动配置逻辑，只要你通过@Bean方式创建RestTemplate，框架会自动将TraceClientHttpRequestInterceptor注入到拦截器列表，无需手动操作：

@Bean
public RestTemplate restTemplate() {
    return new RestTemplate();
}

这种方式创建的RestTemplate发起请求时，会自动在请求头中添加符合W3C标准的traceparent字段，将当前上下文的traceId和spanId传递给下游服务。

3. 手动添加拦截器（自动配置不生效场景） #

如果你的RestTemplate是手动new出来的，或者自定义场景未被自动覆盖，可以手动注入TraceClientHttpRequestInterceptor并添加到拦截器：

@Autowired
private TraceClientHttpRequestInterceptor traceInterceptor;

@Bean
public RestTemplate customRestTemplate() {
    RestTemplate restTemplate = new RestTemplate();
    // 将追踪拦截器放在首位，确保链路信息优先处理
    restTemplate.getInterceptors().add(0, traceInterceptor);
    return restTemplate;
}

TraceClientHttpRequestInterceptor就是Micrometer Tracing中替代原Sleuth的TracingInterceptor的类，专门负责在RestTemplate请求中传播链路上下文。

4. 验证生效状态 #

可以通过查看请求日志或抓包确认：RestTemplate发起的请求中会带有traceparent请求头，格式类似00-<traceId>-<spanId>-01，下游服务只要同样集成Micrometer Tracing，就能自动解析该头实现链路关联。

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