micrometer-tracing-test中TraceContext类型转换异常问题求助

尝试将TraceContext强制转换为SimpleTraceContext以调用baggageFromParent()方法时抛出ClassCastException，运行时上下文实际类型为OtelTraceContext，而非预期的SimpleTraceContext。

Map<String, String> baggageFromParent = ((SimpleTraceContext) context).baggageFromParent();

上下文信息 #

• 库版本：io.micrometer:micrometer-tracing-test:1.1.9
• 额外依赖：micrometer-tracing-bridge-otel（已在类路径中）
• 语言：Java
• 构建工具：Gradle
• 测试框架：JUnit 5

相关代码片段 #

该问题由micrometer-tracing-test v1.1.9新增代码导致，旧版本无此问题：

@Override
public Scope newScope(TraceContext context) {
    if (context == null) {
        SimpleTracer.resetCurrentSpan();
        return Scope.NOOP;
    }
    SimpleSpan previous = SimpleTracer.getCurrentSpan();
    SimpleTracer.setCurrentSpan(context);
    Map<String, String> baggageFromParent = ((SimpleTraceContext) context).baggageFromParent(); // 此处转换失败
    List<BaggageInScope> baggageInScope = baggageFromParent.entrySet()
        .stream()
        .map(entry -> simpleTracer.simpleBaggageManager.createBaggageInScope(context, entry.getKey(),
                entry.getValue()))
        .collect(Collectors.toList());
    return previous != null ? new RevertToPreviousScope(previous, baggageInScope) : new RevertToNullScope();
}

错误信息 #

java.lang.ClassCastException: class io.micrometer.tracing.otel.bridge.OtelTraceContext cannot be cast to class io.micrometer.tracing.test.simple.SimpleTraceContext (io.micrometer.tracing.otel.bridge.OtelTraceContext and io.micrometer.tracing.test.simple.SimpleTraceContext are in unnamed module of loader 'app')

观察结果 #

1. OtelTraceContext和SimpleTraceContext均实现了TraceContext接口。
2. 转换失败的核心原因是运行时context实例为OtelTraceContext，而非SimpleTraceContext。
3. 类路径中同时存在micrometer-tracing-bridge-otel，可能导致容器优先加载Otel实现的TraceContext。

解决方案 #

1. 确保测试环境使用SimpleTracer实例 #

在测试配置中显式注入SimpleTracer和SimpleBaggageManager，避免容器自动选择Otel的实现：

@Configuration
public class TestTracingConfiguration {
    @Bean
    public Tracer tracer() {
        return new SimpleTracer();
    }

    @Bean
    public BaggageManager baggageManager() {
        return new SimpleBaggageManager();
    }
}

同时确保micrometer-tracing-test仅在test源码集引入，避免与生产依赖冲突：

testImplementation 'io.micrometer:micrometer-tracing-test:1.1.9'
implementation 'io.micrometer:micrometer-tracing-bridge-otel:x.x.x' // 生产环境依赖

2. 避免强制类型转换，使用标准API获取Baggage #

不要依赖具体实现类的方法，改用BaggageManager的标准API获取Baggage：

// 替换强制转换的代码
BaggageManager baggageManager = simpleTracer.simpleBaggageManager;
Map<String, String> baggage = baggageManager.getAllBaggage(context).entrySet()
    .stream()
    .collect(Collectors.toMap(
        Map.Entry::getKey,
        entry -> entry.getValue().getValue()
    ));

3. 降级micrometer-tracing-test版本 #

暂时回退到无此问题的版本（如1.1.8），等待官方修复兼容性问题：

testImplementation 'io.micrometer:micrometer-tracing-test:1.1.8'

4. 自定义Scope实现（临时 workaround） #

如果必须使用1.1.9版本，可自定义Scope绕过类型转换：

public class FixedSimpleScope implements Scope {
    private final SimpleSpan previousSpan;
    private final List<BaggageInScope> baggageInScope;

    public FixedSimpleScope(SimpleSpan previousSpan, TraceContext context, SimpleBaggageManager baggageManager) {
        this.previousSpan = previousSpan;
        this.baggageInScope = Optional.ofNullable(context)
            .map(baggageManager::getAllBaggage)
            .orElse(Collections.emptyMap())
            .entrySet()
            .stream()
            .map(entry -> baggageManager.createBaggageInScope(context, entry.getKey(), entry.getValue().getValue()))
            .collect(Collectors.toList());
    }

    @Override
    public void close() {
        SimpleTracer.setCurrentSpan(previousSpan);
        baggageInScope.forEach(BaggageInScope::close);
    }
}

然后修改newScope方法使用该自定义Scope：

@Override
public Scope newScope(TraceContext context) {
    if (context == null) {
        SimpleTracer.resetCurrentSpan();
        return Scope.NOOP;
    }
    SimpleSpan previous = SimpleTracer.getCurrentSpan();
    SimpleTracer.setCurrentSpan(context);
    return previous != null 
        ? new FixedSimpleScope(previous, context, simpleTracer.simpleBaggageManager) 
        : new FixedSimpleScope(null, context, simpleTracer.simpleBaggageManager);
}

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