Kotlin协程切换线程时Micrometer traceId丢失问题咨询

核心问题 #

Kotlin协程的上下文机制与Java线程上下文相互独立，即便引入了context-propagation库，默认情况下Micrometer Trace上下文也不会自动同步到协程上下文中，导致协程切换（比如调用delay）后Trace ID丢失。

解决步骤 #

1. 确认依赖兼容性 #

你当前使用的io.micrometer:context-propagation:1.0.2与Spring Boot 3版本适配，无需调整依赖版本。

2. 绑定Micrometer上下文到Kotlin协程上下文 #

创建Spring配置类，将Micrometer的上下文传播器注册到Kotlin协程上下文，确保协程切换时自动传递Trace信息：

import io.micrometer.context.ContextRegistry
import kotlinx.coroutines.asContextElement
import org.springframework.context.annotation.Bean
import org.springframework.context.annotation.Configuration

@Configuration
class CoroutineTracePropagationConfig {

    @Bean
    fun micrometerCoroutineContextElement(contextRegistry: ContextRegistry) =
        contextRegistry.asContextElement()
}

3. 配置日志MDC同步（可选） #

若日志依赖MDC输出Trace ID，需确保协程切换时MDC同步。在application.yml中添加以下配置：

logging:
  pattern:
    level: "%5p [traceId=%X{traceId:-}, spanId=%X{spanId:-}]"

management:
  tracing:
    brave:
      propagation:
        type: B3
      mdc:
        enabled: true

4. 验证效果 #

无需修改原TestController代码，重启应用后调用/test接口，日志中after的Trace ID将与before保持一致。

补充说明 #

• Spring WebFlux的协程支持默认通过Dispatcher管理协程，但必须显式绑定上下文传播机制才能传递Trace信息。
• 确保kotlinx-coroutines-reactor与reactor-core版本匹配，避免兼容性问题。

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