Spring Boot3升级后Kotlin协程中TraceId丢失问题求助

核心原因分析 #

你遇到的问题本质是协程切换时Micrometer Tracing上下文未正确传播：控制器方法的@Observed会初始化TraceId上下文，但调用服务层suspend方法时，协程调度可能导致上下文丢失——K8s环境的协程调度策略与本地存在差异，放大了这个问题。JVM本身（OpenJDK vs AWS Corretto）不是直接诱因，但K8s的资源限制、JVM启动参数可能间接影响协程上下文的传递逻辑。

解决方案步骤 #

1. 启用协程上下文自动传播 #

在application.yml或application.properties中添加配置，强制Spring将Tracing信息绑定到协程上下文：

spring:
  coroutine:
    context-propagation: true

该配置会自动完成Observation（包含TraceId）上下文的协程内传播，无需手动传递。

2. 手动绑定Observation上下文（自动传播失效时备用） #

如果自动传播不生效，可在控制器中手动将当前Observation上下文传递给服务层调用：

@PostMapping("/upload-file")
@Observed
suspend fun uploadFile(
    serverWebExchange: ServerWebExchange,
    observationRegistry: ObservationRegistry
): ResponseEntity<MessageResponse> {
    logger.debug("uploadFile")
    // 获取当前控制器的TraceId上下文
    val currentObservation = Observation.getCurrentObservation(observationRegistry)
    // 在Observation上下文包裹下执行服务调用
    withContext(currentObservation?.asContextElement() ?: EmptyCoroutineContext) {
        importService.handle(getMultipartDataPart("file", serverWebExchange))
    }
    return ResponseEntity(MessageResponse("Success."), OK)
}

3. 为服务层suspend方法添加@Observed注解 #

给服务层的suspend方法也加上@Observed，确保上下文被正确延续：

@Service
class ImportService() {

    @Observed
    suspend fun handle(fileAsByteArray: ByteArray) {
        log.debug("Import file.")
        // ...业务逻辑
    }
}

4. 排查K8s环境的配置差异 #

• 对比本地与K8s的JVM启动参数，确保没有禁用协程上下文相关的优化（如极端参数-XX:+DisableAttachMechanism）。
• 检查K8s容器的资源限制，避免因内存/CPU不足导致协程调度异常，间接引发上下文丢失。

5. 验证依赖兼容性 #

确保micrometer-tracing-bridge-brave版本与Spring Boot 3完全兼容，建议通过spring-boot-starter-actuator传递依赖，避免手动指定版本引发冲突：

// 移除手动指定的micrometer依赖版本，由spring-boot-starter-actuator统一管理
implementation("org.springframework.boot:spring-boot-starter-actuator")

关键验证点 #

• 避免在服务层使用Dispatchers.Unconfined调度器（该调度器会忽略上下文传播），优先使用Dispatchers.IO或WebFlux提供的调度器。
• 确认服务层日志的Logger配置包含%X{traceId}字段（虽然控制器日志正常，但需排除Logger配置差异）。

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