.NET 6中HttpClient发送未知父Span ID问题排查

问题原因 #

你遇到的Span ID不匹配是.NET分布式追踪的正常设计行为：

• 日志中打印的Activity.Current是当前代码执行所在的父Span；
• HttpClient发送请求时，会自动基于这个父Span生成一个子Span，这个子Span的ID才会被填充到traceparent请求头里。

每个外部HTTP调用都会生成独立的子Span，用来单独标记远程调用的链路节点，这是.NET内置分布式追踪机制的标准逻辑。

解决方案 #

1. 正确获取HTTP调用对应的Span信息 #

如果需要在api-A中查看HttpClient发送的traceparent对应的Span ID，无需手动修改代码逻辑，可通过以下方式捕获：

• 调整日志级别为Debug或Trace，启用.NET内置日志输出，你会在日志中看到System.Net.Http相关条目，其中包含子Span的ID和对应的traceparent值；
• 或者通过DiagnosticListener监听HTTP请求发送事件，示例代码如下：

// 在api-A的Program.cs中注册监听器
var listener = new DiagnosticListener("System.Net.Http");
listener.Subscribe(new HttpRequestTraceObserver());

public class HttpRequestTraceObserver : IObserver<KeyValuePair<string, object>>
{
    public void OnCompleted() { }
    public void OnError(Exception error) { }
    public void OnNext(KeyValuePair<string, object> value)
    {
        if (value.Key == "System.Net.Http.HttpRequestOut")
        {
            if (value.Value is HttpRequestMessage request)
            {
                var traceparent = request.Headers.TryGetValues("traceparent", out var values) 
                    ? values.First() 
                    : "N/A";
                var currentSpanId = Activity.Current?.SpanId.ToString();
                Console.WriteLine($"HttpRequestOut - traceparent: {traceparent}, SpanId: {currentSpanId}");
            }
        }
    }
}

2. 验证链路追踪的正确性 #

在api-B的接口中打印接收到的traceparent请求头，会发现它的Trace ID与api-A父Span的Trace ID一致，Span ID则是api-A中HttpClient生成的子Span ID，完全符合分布式追踪的链路层级：

// api-B接口示例代码
[HttpGet("health")]
public IActionResult Health()
{
    if (Request.Headers.TryGetValues("traceparent", out var values))
    {
        _logger.LogInformation($"Received traceparent: {values.First()}");
    }
    return Ok();
}

3. 不要手动干预Span创建 #

.NET的HttpClient已完全集成分布式追踪逻辑，会自动处理父子Span的关联，手动创建或修改Span反而可能破坏链路的正确性。

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