8.14禁用分布式跟踪上下文(traceparent 标头)

创建于 2026 年 8 月 17 日约 1 分钟读完

在发起 HTTP 远程请求时,默认情况下,当前的 Activity 所包含的分布式跟踪上下文(如 traceparenttracestate)会被自动注入到请求的 HTTP 标头中。这一机制有助于下游服务正确识别并关联到同一分布式跟踪链路。

如果出于某些业务或安全需求,需要禁用该自动注入行为,可以通过以下代码进行配置:

csharp
// 配置默认客户端services.AddHttpClient(string.Empty, client => { })    .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler()    {        ActivityHeadersPropagator = null // 禁用分布式上下文传播,或使用 DistributedContextPropagator.CreateNoOutputPropagator()    });

通过将 ActivityHeadersPropagator 设置为 null,可阻止运行时自动将当前活动的分布式跟踪信息注入到 HTTP 请求头中,从而实现对跟踪上下文传播的控制。相关 Issue 了解:#109558#90407#IC7ZZS