如何为HttpClientFactory创建的命名HttpClient添加X-RequestId请求头？

为什么原有方案无效 #

你在AddHttpClient的configureClient委托里设置请求头的方式，只会在HttpClient实例首次创建时执行一次，DefaultRequestHeaders会被固定为第一次请求的X-RequestId，后续请求无法动态更新，这就是问题的核心。

最优实现：用DelegatingHandler统一处理请求头传递 #

ASP.NET Core的HttpClientFactory提供的消息处理器（DelegatingHandler）机制，会在每个请求发送前执行，完美适配“每个请求动态添加X-RequestId”的需求，具体步骤如下：

1. 注册IHttpContextAccessor
   要在处理器中获取当前请求的上下文，需先注册IHttpContextAccessor（默认未注册）：

   services.AddHttpContextAccessor();
   

2. 创建自定义请求头传递处理器
   实现DelegatingHandler，在请求发送前从当前HttpContext提取X-RequestId并添加到下游请求：

   public class RequestIdPropagationHandler : DelegatingHandler
   {
       private readonly IHttpContextAccessor _httpContextAccessor;
       private const string RequestIdHeader = "X-RequestId";
   
       public RequestIdPropagationHandler(IHttpContextAccessor httpContextAccessor)
       {
           _httpContextAccessor = httpContextAccessor;
       }
   
       protected override async Task<HttpResponseMessage> SendAsync(
           HttpRequestMessage request, 
           CancellationToken cancellationToken)
       {
           var currentContext = _httpContextAccessor.HttpContext;
           if (currentContext != null && currentContext.Request.Headers.TryGetValue(RequestIdHeader, out var requestIdValue))
           {
               // 用TryAdd避免重复添加头引发的异常
               request.Headers.TryAddWithoutValidation(RequestIdHeader, requestIdValue.ToString());
           }
   
           return await base.SendAsync(request, cancellationToken);
       }
   }
   

3. 关联处理器到命名HttpClient
   将处理器注册为作用域服务，并配置命名HttpClient时添加该处理器：

   // 注册自定义处理器
   services.AddScoped<RequestIdPropagationHandler>();
   
   // 配置命名HttpClient
   services.AddHttpClient(PatClientName, (sp, c) =>
   {
       var options = sp.GetRequiredService<IOptions<PatServiceOptions>>().Value;
       c.BaseAddress = new Uri(options.BaseAddress);
   })
   .AddHttpMessageHandler<RequestIdPropagationHandler>();
   

关于“作用域/瞬时对象”方案的评估 #

创建存储X-RequestId的作用域对象是可行的，但并非最优选择：

• 这种方式需要额外流程：编写中间件在请求进入时从Header提取RequestId并存入作用域对象，再在所有使用HttpClient的服务中注入该对象，手动添加请求头。
• 代码冗余且易遗漏：每个调用下游API的地方都要手动处理请求头，无法统一管控，维护成本更高。

相比之下，DelegatingHandler的方式完全在HttpClient的请求管道中统一处理，业务代码无需关心请求头传递逻辑，更贴合ASP.NET Core的设计理念，扩展性和维护性更好。

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