OpenTelemetry中Scope与startSpan/span.end的作用差异及相关疑问

先看你给出的手动插桩代码：

@Inject
Tracer tracer;

public String instrumentedMethod() {
  // ...
  Span span = tracer.spanBuilder("interesting operation").startSpan();
  span.setAttribute("custom.info", "some info");
  try (Scope scope = span.makeCurrent()) {
    // 业务逻辑
  }
  finally {
    span.end();
  }
  // ...
}

一、startSpan()/span.end() 和 span.makeCurrent()/scope.end() 的作用分别是什么？ #

1. startSpan() 和 span.end()：管理Span本身的生命周期 #

• startSpan()：创建并启动一个Span，记录Span的开始时间戳，此时Span进入活跃状态，但还未与当前线程上下文绑定。
• span.end()：结束这个Span，记录结束时间戳，标记Span生命周期的完成。只有调用end()，Span才会被OpenTelemetry导出器收集并上报到监控系统，否则该Span会一直处于未完成状态，永远不会被上报。

2. span.makeCurrent() 和 scope.end()：管理线程上下文绑定 #

• span.makeCurrent()：将当前Span绑定到当前线程的上下文中，使其成为线程的“当前Span”。后续同一线程内执行的代码（比如调用其他被插桩的方法、OpenTelemetry自动仪器化的组件）生成的子Span，会自动将这个Span作为父Span，从而构建完整的调用链路。
• scope.end()：解除当前Span与线程上下文的绑定，恢复线程之前的上下文状态。使用try-with-resources语法时，scope.end()会在代码块结束时自动调用，避免后续线程执行其他逻辑时错误地沿用这个Span作为当前上下文。

二、是否可以省略scope？ #

可以，但需结合业务场景判断：

• 如果instrumentedMethod()内部没有需要生成子Span的操作（比如仅执行纯本地逻辑，不调用其他被监控的方法、组件），省略scope完全没问题，只要记得调用span.end()即可。
• 如果方法内部有子操作需要与这个Span建立父子链路（比如调用被OpenTelemetry监控的HTTP客户端、数据库操作），则必须调用span.makeCurrent()绑定上下文，否则子操作生成的Span会变成根Span，导致整个调用链路断裂，无法追踪完整请求流程。

三、使用scope时span.end()是否多余？ #

完全不多余，两者负责的是完全不同的逻辑：

• scope.end()仅解除Span与线程上下文的绑定，不影响Span本身的生命周期——此时Span仍处于活跃状态。
• 只有调用span.end()，才会真正结束Span的生命周期，使其被导出器收集上报。如果只调用scope.end()而不调用span.end()，该Span会一直停留在活跃状态，永远不会被上报，相当于白创建了。

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