.NET 6中app.UseHttpLogging()无法记录中间件修改的响应怎么办？

问题原因 #

你使用Response.OnStarting注册的响应头修改回调，会在所有中间件处理完响应之后、响应即将发送给客户端之前执行。而UseHttpLogging()中间件默认是在自身的await next()之后（响应返回流程中）收集响应头信息，此时你的修改回调还未触发，因此日志无法捕获到这个后续添加的响应头。而在控制器中直接添加响应头，是在终端中间件（控制器）执行时完成的，HttpLogging收集响应头时该字段已存在，所以能被正常记录。

解决方法 #

方法一：调整中间件顺序 + 直接修改响应头（推荐） #

将UseHttpLogging()放在自定义中间件之前注册，同时修改自定义中间件逻辑，在await nextMiddleware()之后直接修改响应头（此时响应尚未发送，仍可修改头信息）：

var builder = WebApplication.CreateBuilder(args);
 
builder.Services.AddHttpLogging(logging =>
{
    logging.LoggingFields = HttpLoggingFields.All;
    logging.RequestHeaders.Add("x-correlation-id");
    logging.ResponseHeaders.Add("x-correlation-id"); 
});

var app = builder.Build(); 

// 先注册HttpLogging中间件，确保响应返回时后处理
app.UseHttpLogging();

// 再注册自定义中间件，在响应返回流程中修改头
app.Use(async (context, nextMiddleware) =>
{
    await nextMiddleware();
    
    var correlationId = context.Request.Headers["x-correlation-id"].FirstOrDefault() ?? string.Empty;
    var newCorrelationId = $"test {correlationId}";
    
    if (context.Response.Headers.ContainsKey("x-correlation-id"))
        context.Response.Headers["x-correlation-id"] = newCorrelationId;
    else
        context.Response.Headers.Add("x-correlation-id", newCorrelationId);
});

app.UseRouting();
app.MapControllers();

app.Run();

方法二：自定义HttpLogging的收集时机（复杂场景可选） #

如果必须依赖Response.OnStarting回调，可自定义HttpLoggingMiddleware的逻辑，让它也通过Response.OnStarting来收集响应头，确保在你的修改回调执行后再捕获数据。这种方法需要扩展框架原生逻辑，仅适合特殊场景使用。

验证效果 #

修改后，HttpLogging会在响应返回流程中等待自定义中间件完成响应头修改，再执行信息收集，日志中就能正常记录x-correlation-id响应头。

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