如何在ASP.NET Core中间件设置不被异常覆盖的HTTP响应头

这个问题我之前也碰到过，根源在于控制器抛出异常时，ASP.NET Core的默认异常处理流程会创建一个全新的HttpResponse实例来生成500错误响应。你通过context.Response.OnStarting绑定的委托是关联在最初的Response对象上的，新的Response并没有绑定这个逻辑，所以你添加的头就被丢弃了。

下面给你两个靠谱的解决方案，按推荐程度排序：

方案一：使用IAlwaysRunResultFilter（推荐） #

MVC的IAlwaysRunResultFilter是专门设计用来不管Action执行成功还是抛出异常，都会运行的过滤器，完美适配你需要全局添加响应头（比如请求ID）的场景。

步骤1：实现自定义过滤器 #

创建一个过滤器类，实现IAlwaysRunResultFilter接口：

public class GlobalResponseHeaderFilter : IAlwaysRunResultFilter
{
    // 在结果执行前添加响应头
    public void OnResultExecuting(ResultExecutingContext context)
    {
        // 用TryAdd避免重复添加（比如多个过滤器或中间件操作同一个头）
        context.HttpContext.Response.Headers.TryAdd("X-Added-Key", "X-Added-Value");
        // 如果是请求ID，可以在这里生成并添加，比如：
        // var requestId = Guid.NewGuid().ToString();
        // context.HttpContext.Response.Headers.TryAdd("X-Request-ID", requestId);
    }

    // 结果执行后的清理逻辑（可选）
    public void OnResultExecuted(ResultExecutedContext context)
    {
        // 不需要的话可以留空
    }
}

步骤2：注册过滤器到MVC pipeline #

在Startup.ConfigureServices里把过滤器添加到MVC的全局过滤器集合中：

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc(options =>
    {
        // 添加全局过滤器
        options.Filters.Add<GlobalResponseHeaderFilter>();
    });
}

这样不管是访问/success返回正常响应，还是访问/failure触发异常，这个过滤器都会执行，响应头会被正确添加。

方案二：改进中间件逻辑 #

如果你更倾向于用中间件实现，可以调整中间件的逻辑，确保在异常处理完成后，给新的Response也添加头。

修改后的中间件代码 #

public void Configure(IApplicationBuilder app)
{
    // 如果使用了自定义异常处理中间件，要放在它之后
    // app.UseExceptionHandler("/error");

    app.Use(async (HttpContext context, Func<Task> next) =>
    {
        try
        {
            await next();
        }
        finally
        {
            // 不管是否发生异常，都尝试添加响应头
            if (!context.Response.Headers.ContainsKey("X-Added-Key"))
            {
                context.Response.Headers.TryAdd("X-Added-Key", "X-Added-Value");
            }
        }
    })
    .UseMvc();
}

注意：如果你的项目中使用了UseExceptionHandler，一定要把这个自定义中间件放在UseExceptionHandler之后，这样才能捕获到异常处理后的新Response。

为什么原来的方式不行？ #

再补充下原理帮助你理解：
当控制器抛出异常时，MVC的异常处理机制会终止当前的Response，创建一个新的Response来生成错误页面/响应。你之前绑定的OnStarting委托是针对旧的Response的，新的Response并没有这个委托，所以头不会被添加。而IAlwaysRunResultFilter是MVC pipeline的一部分，会参与到异常处理后的结果流程中，所以能确保头被添加。

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