多线程Java SpringBoot集成Jaeger OpenTracing时Span干扰问题求助

问题根因 #

你遇到的跨请求Span串连问题核心是Scope未正确关闭导致线程池复用线程时，ThreadLocal存储的上一个请求的链路上下文残留：

1. 你自定义的startSpanInScope方法调用了scopeManager.activate(span)后，仅返回了Span对象，丢失了Scope实例，无法主动关闭Scope
2. 默认Jaeger的ScopeManager基于ThreadLocal实现，若请求处理线程来自线程池（Grpc默认用线程池处理请求），上一个请求的Scope未关闭时，ThreadLocal中存储的活跃Span不会被清除，新请求创建Span时会自动将残留的其他请求的Span设为父节点，导致链路串连
3. 单请求测试时无复用线程场景，因此不会触发问题，并发请求下线程池复用后问题暴露

解决方案 #

步骤1：修改Span启动工具类 #

改用OpenTracing提供的startActive方法，设置自动在Scope关闭时结束Span，直接返回Scope实例供调用方管理：

public static Scope startSpanInScope(Tracer tracer, String spanName) {
    if (tracer == null) {
        return null;
    }
    // 入参true表示Scope关闭时自动调用span.finish()
    return tracer.buildSpan(spanName).startActive(true);
}

步骤2：用try-with-resources管理Scope生命周期 #

Java的try-with-resources会在代码块执行结束后自动调用Scope.close()，清除当前线程的ThreadLocal链路上下文，无需手动关闭：

@Override
public void service(Request request, StreamObserver<ResultGrpc> responseObserver) {
    try (Scope scope = startSpanInScope(this.tracer, "service")) {
        // 若需要给当前Span打标签、日志，可通过scope.span()获取实例
        // scope.span().setTag("requestId", request.getRequestId());
        ...
        innerService();
        ...
    }
}

步骤3：innerService创建子Span遵循同样规则 #

innerService中创建Span时也采用相同写法，会自动将当前线程的活跃Span（即service对应的Span）设为父节点，实现嵌套结构：

public void innerService() {
    try (Scope scope = startSpanInScope(this.tracer, "innerService")) {
        // 业务逻辑
    }
}

修改后并发请求下，每个线程的链路上下文会随请求处理结束自动清除，不会出现跨请求Span关联的问题，且同请求内的Span会保持正确的父子嵌套关系。

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