C#使用OpenTelemetry设置trace_id/span_id为correlation-id追踪请求

核心结论 #

OpenTelemetry .NET 遵循 W3C Trace Context 规范，TraceId、SpanId 在 Span（对应 .NET 里的 Activity 对象）创建启动后为只读状态，公开API不支持修改，你之前自定义处理器无法修改ID是框架的设计约束，不是实现逻辑错误。
你要实现的「将TraceId/SpanId作为correlation-id完成链路关联」完全不需要修改OTel原生ID，通过头映射逻辑即可实现，不会破坏原生链路追踪能力。

可行实现方案 #

1. 入站请求自动对齐 correlation-id #

不需要修改OTel的ID生成逻辑，在OTel中间件之后注册一个轻量中间件，在请求处理管道早期读取当前链路的TraceId，注入到请求和响应的x-correlation-id头即可：

// 注意注册顺序：必须放在OTel接入中间件之后，路由、业务中间件之前
app.Use(async (context, next) =>
{
    var currentActivity = Activity.Current;
    if (currentActivity != null)
    {
        // 按需选择用TraceId（全局链路唯一）还是SpanId（当前节点唯一）作为correlation-id
        var correlationId = currentActivity.TraceId.ToString();
        
        // 写入请求头，供业务逻辑直接读取
        if (!context.Request.Headers.ContainsKey("x-correlation-id"))
        {
            context.Request.Headers.Add("x-correlation-id", correlationId);
        }

        // 写入响应头，方便上游调用方获取关联ID
        context.Response.OnStarting(() =>
        {
            if (!context.Response.Headers.ContainsKey("x-correlation-id"))
            {
                context.Response.Headers.Add("x-correlation-id", correlationId);
            }
            return Task.CompletedTask;
        });
    }

    await next();
});

2. 出站请求自动传递 correlation-id #

如果服务需要调用下游接口，直接在HttpClient的消息管道里追加逻辑，把当前链路的TraceId写入出站请求的x-correlation-id头即可，不需要修改OTel的传播配置：

services.AddHttpClient("DownstreamClient")
    .AddHttpMessageHandler(() => new CorrelationIdHandler());

// 自定义消息处理器
public class CorrelationIdHandler : DelegatingHandler
{
    protected override Task<HttpResponseMessage> SendAsync(HttpRequestMessage request, CancellationToken cancellationToken)
    {
        var currentActivity = Activity.Current;
        if (currentActivity != null)
        {
            request.Headers.TryAddWithoutValidation("x-correlation-id", currentActivity.TraceId.ToString());
        }
        return base.SendAsync(request, cancellationToken);
    }
}

3. 兼容已有 x-correlation-id 系统的方案 #

如果你的老系统已经在使用固定规则生成x-correlation-id，需要让OTel的TraceId和入站带的correlation-id保持一致，不要在Span创建后尝试修改ID，要在根Span生成前做自定义ID注入：

• 实现自定义ITraceIdGenerator，在请求刚进入管道时，先读取请求头里的x-correlation-id，校验格式符合TraceId规范（32位十六进制字符串）后，直接用这个值生成根Span的TraceId，从源头保证ID一致，避免后续修改的兼容性问题。

为什么自定义Processor无法修改ID #

你之前通过自定义BaseProcessor<Activity>尝试修改ID时只能读不能写，是因为.NET的Activity类型在调用Start()方法后，TraceId、SpanId属性的公开setter会被标记为不可用，只有框架内部的初始化逻辑有权限赋值。这个设计是为了避免链路ID被业务逻辑意外篡改，导致链路断裂、日志关联失效、采样导出异常等问题。

注意：不要通过反射修改Activity的私有字段强行更改ID，这种方式在不同.NET版本、OTel版本下兼容性极差，生产环境会出现不可预知的链路异常，完全不推荐使用。

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