Spring Boot 3.3.3反应式WebClient日志traceId偶发缺失问题求助

针对Spring Boot 3.3.3 + Java 21 + 反应式WebClient + Micrometer-OTel桥接场景下的traceId日志缺失问题，结合版本差异（3.3.2正常），可以从以下几个方向排查修复：

1. 对齐依赖版本，避免冲突 #

Spring Boot 3.3.3对Micrometer Tracing等组件的依赖版本做了更新，不要手动指定micrometer-tracing-bridge-otel的版本，完全依赖Spring Boot的依赖管理来自动对齐版本，避免因版本不匹配导致的上下文传播异常。

2. 确认WebClient的Trace拦截器配置 #

确保WebClient在构建时正确注入了TracingClientHttpConnector，否则trace上下文无法在请求链路中传递：

@Bean
public WebClient webClient(TracingClientHttpConnector tracingClientHttpConnector) {
    return WebClient.builder()
            .clientConnector(tracingClientHttpConnector)
            .build();
}

如果是使用自动配置的WebClient，不要在自定义配置中覆盖掉默认的trace拦截器逻辑。

3. 修复Reactor上下文与MDC的同步 #

反应式场景下，MDC的trace信息依赖Reactor Context的传播，Spring Boot 3.3.3可能在虚拟线程+Reactor的组合下存在上下文同步bug，可以通过以下方式强制同步：

• 显式从Reactor Context中提取traceId并绑定到MDC（适合局部调试）：

webClient.get()
        .uri("/target-api")
        .retrieve()
        .bodyToMono(String.class)
        .contextWrite(context -> {
            String traceId = context.get(TraceContext.class).traceId();
            MDC.put("traceId", traceId);
            return context;
        })
        .doAfterTerminate(MDC::clear)
        .subscribe(result -> log.info("API响应: {}", result));

• 确保ReactorContextPropagator正确配置，Micrometer默认会自动处理，但可以显式开启：

management.tracing.propagation.context-propagators=reactor-context

4. 排查Spring Boot 3.3.3的已知bug #

查看Spring Boot 3.3.3的官方Release Notes，确认是否存在trace传播相关的已知问题。目前已知部分用户反馈在虚拟线程启用时，Reactor上下文的trace信息无法正确传递到MDC，临时解决方案可以：

• 降级到Spring Boot 3.3.2（如果业务允许）；
• 升级到Spring Boot 3.3.x的最新补丁版本（如3.3.4，若已发布），看是否修复了该问题。

5. 验证日志配置的正确性 #

检查日志框架（如Logback）的pattern是否正确引用了MDC中的traceId：

<encoder>
    <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg traceId=%X{traceId}%n</pattern>
</encoder>

同时确保trace采样率设置为100%，避免部分请求不生成traceId：

management.tracing.sampling.probability=1.0

6. 调整虚拟线程配置组合 #

尝试拆分虚拟线程的配置，分别测试不同组合：

• 只启用Spring虚拟线程：spring.threads.virtual.enabled=true，移除-Dreactor.schedulers.defaultBoundedElasticOnVirtualThreads=true；
• 只启用Reactor虚拟线程：保留-Dreactor.schedulers.defaultBoundedElasticOnVirtualThreads=true，关闭spring.threads.virtual.enabled；
  观察traceId的输出情况，定位是否是某一种配置组合导致的问题。

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