Spring Boot Webflux集成Micrometer Tracing配置失效问题求助

Spring Webflux 完全支持 Micrometer Tracing，你的问题大概率是依赖配置不完整或启动顺序有误，以下是完整的集成步骤和验证示例：

一、正确的依赖配置 #

Micrometer Tracing 仅提供核心 API，必须搭配具体的桥接实现（如 Brave），同时要确保 Webflux 的自动配置生效。在 pom.xml 中添加以下完整依赖：

<!-- Webflux 基础依赖 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
</dependency>
<!-- Micrometer Tracing 核心API -->
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-tracing</artifactId>
</dependency>
<!-- Brave 桥接实现（替代原Spring Cloud Sleuth的核心逻辑） -->
<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>
<!-- 若需上报链路到Zipkin，添加此依赖 -->
<dependency>
    <groupId>io.zipkin.reporter2</groupId>
    <artifactId>zipkin-reporter-brave</artifactId>
</dependency>

二、必要配置项 #

在 application.yml 中添加追踪相关配置，确保采样和传播规则生效：

management:
  tracing:
    sampling:
      probability: 1.0  # 测试阶段设为100%采样
    propagation:
      type: B3  # 兼容原Spring Cloud Sleuth的B3格式，可选W3C
  endpoints:
    web:
      exposure:
        include: tracing, metrics  # 暴露追踪端点用于验证

三、启动类正确配置 #

Hooks.enableAutomaticContextPropagation() 必须在 Spring 应用启动前调用，确保上下文传播生效：

@SpringBootApplication
public class WebfluxTracingDemoApplication {
    public static void main(String[] args) {
        // 必须放在SpringApplication.run之前
        Hooks.enableAutomaticContextPropagation();
        SpringApplication.run(WebfluxTracingDemoApplication.class, args);
    }
}

四、验证示例 #

编写一个简单的 Webflux 接口，通过日志 MDC 验证链路 ID 是否输出：

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import reactor.core.publisher.Mono;

@RestController
public class TraceTestController {
    private static final Logger log = LoggerFactory.getLogger(TraceTestController.class);

    @GetMapping("/trace-test")
    public Mono<String> traceTest() {
        log.info("开始处理请求");
        return Mono.just("链路追踪测试成功")
                .doOnNext(result -> log.info("请求处理完成，返回结果: {}", result));
    }
}

启动应用后调用 /trace-test 接口，日志中会自动携带 traceId 和 spanId，类似如下格式：

2024-05-20 14:30:00.123  INFO [,7a8b9c0d,1e2f3g4h] 12345 --- [ctor-http-nio-2] c.e.w.TraceTestController                : 开始处理请求
2024-05-20 14:30:00.124  INFO [,7a8b9c0d,1e2f3g4h] 12345 --- [ctor-http-nio-2] c.e.w.TraceTestController                : 请求处理完成，返回结果: 链路追踪测试成功

五、常见问题排查 #

1. 版本兼容性：确保 Spring Boot 3.x 对应 Micrometer Tracing 1.1.x+，版本不匹配会导致自动配置失效；
2. 过滤器顺序：若自定义了 WebFilter，需确保其顺序晚于 Micrometer 自动注册的 TraceWebFilter，避免覆盖上下文；
3. 上下文传播：确认 Hooks.enableAutomaticContextPropagation() 调用时机正确，必须在 Spring 启动前执行。

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