OpenTelemetry Java创建Span时出现无效幽灵链接问题咨询

问题描述 #

我们使用OpenTelemetry Java 1.36.0版本，通过SpanBuilder创建新Span并添加一个关联Span的链接，日志已确认仅通过API添加了一个链接。链接创建成功生成了关联traceId和spanId的有效链接，但同时出现了一个指向当前traceId、spanId全为0的无效幽灵链接。

预期结果：

trace (id=1)
- span (id=15)
  - link (related - traceId=2, spanId = 20)

实际结果：

trace (id=1)
- span (id=15)
  - link (related - traceId=1, spanId = 00) - 无效spanId
  - link (related - traceId=2, spanId = 20)

环境与已尝试操作 #

• Java版本：17
• OpenTelemetry版本：1.36.0（已尝试升级至最新版本）
• 已验证操作：通过日志确认仅调用一次addLink方法

相关代码片段 #

SpanBuilder spanBuilder = tracer.spanBuilder(spanName)
                 .setSpanKind(kind)
                 .setNoParent();

if (linkedSpans != null && !linkedSpans.isEmpty()) {
    for (Span linked:  linkedSpans) {
        log.debug("Adding link to span {} - {}", spanName, linked.getSpanContext().getSpanId());
        spanBuilder.addLink(linked.getSpanContext());
    }
}

io.opentelemetry.api.trace.Span oSpan = spanBuilder.startSpan();

问题 #

请问这是个例问题还是其他人也遇到过？

这个问题并非个例，在OpenTelemetry Java的部分版本（包括1.36.0及部分后续版本）的社区讨论中，有不少用户反馈过类似的幽灵链接问题。

常见触发原因包括：

• setNoParent()的SDK内部行为：调用setNoParent()创建根Span时，部分版本的SDK会默认添加一个指向空SpanContext（traceId为当前traceId、spanId全0）的链接，这属于SDK的潜在bug，并非业务代码问题。
• 依赖冲突导致版本未真正升级：如果升级最新版本后问题仍存在，大概率是项目依赖树中存在旧版本的OpenTelemetry SDK包，导致实际运行的还是有问题的版本。
• 自定义SpanProcessor/Exporter的额外处理：部分自定义的Span处理器或导出器可能在导出阶段额外添加无效链接，可切换为官方默认的SimpleSpanProcessor验证是否是此原因。

建议排查方向：

1. 用依赖分析工具（如mvn dependency:tree或Gradle依赖报告）确认项目中OpenTelemetry相关依赖的实际版本，排除冲突。
2. 暂时移除自定义SpanProcessor和Exporter，使用官方默认实现测试问题是否消失。
3. 查看OpenTelemetry Java的官方bug记录，确认是否有已修复的相关issue，若有可针对性升级到修复后的版本。

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