ASP.NET Core 6中无法设置Connection响应头的问题求助

原因：HTTP连接管理头由服务器自动管控 #

ASP.NET Core的HTTP处理管道（核心是Kestrel服务器组件）会自动接管Connection这类与连接生命周期强相关的响应头。这类头属于HTTP协议层面的控制字段，服务器会根据当前连接的协议版本（比如HTTP/1.1默认启用持久连接）、连接状态自动生成或调整，因此手动添加的Connection: Close会被管道覆盖或移除。

解决办法：使用官方推荐的连接关闭方式 #

无需手动添加响应头，直接通过IHttpResponseFeature标记连接关闭，服务器会自动生成Connection: Close头。修改控制器代码如下：

[ApiController]
[Route("[controller]")]
public class HeaderTestController : ControllerBase
{
    [HttpGet]
    public IActionResult Get()
    {
        Response.Headers.Add("Foo", "Bar");
        // 设置连接关闭标记，服务器会自动添加Connection: Close头
        HttpContext.Features.Get<IHttpResponseFeature>().ConnectionClose = true;

        return NoContent();
    }
}

这种方式符合ASP.NET Core的设计规范，不会被管道拦截，同时能正确触发遗留终端的维护模式逻辑。

备选方案（不推荐）：强制允许自定义Connection头 #

如果因特殊场景必须手动控制该头，可通过配置Kestrel的连接适配器绕过限制，但这种方式可能破坏HTTP协议的正常连接管理逻辑，仅建议在极端场景下使用：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();

// 配置Kestrel允许自定义Connection头
builder.WebHost.ConfigureKestrel(options =>
{
    options.ListenAnyIP(5000, listenOptions =>
    {
        listenOptions.Protocols = HttpProtocols.Http1AndHttp2;
        listenOptions.ConnectionAdapters.Add(new PreserveConnectionHeaderAdapter());
    });
});

var app = builder.Build();

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

// 自定义连接适配器，保留手动添加的Connection头
public class PreserveConnectionHeaderAdapter : IConnectionAdapter
{
    public async Task OnConnectionAsync(ConnectionAdapterContext context)
    {
        var originalFeature = context.Connection.Features.Get<IHttpResponseFeature>();
        var customFeature = new CustomHttpResponseFeature(originalFeature);
        context.Connection.Features.Set<IHttpResponseFeature>(customFeature);
        
        await context.Next(context.Connection);
    }

    private class CustomHttpResponseFeature : IHttpResponseFeature
    {
        private readonly IHttpResponseFeature _inner;
        public CustomHttpResponseFeature(IHttpResponseFeature inner) => _inner = inner;

        public bool ConnectionClose 
        { 
            get => _inner.ConnectionClose; 
            set => _inner.ConnectionClose = value; 
        }

        // 其他属性和方法直接委托给内部实现
        public int StatusCode { get => _inner.StatusCode; set => _inner.StatusCode = value; }
        public string ReasonPhrase { get => _inner.ReasonPhrase; set => _inner.ReasonPhrase = value; }
        public IHeaderDictionary Headers => _inner.Headers;
        public Stream Body { get => _inner.Body; set => _inner.Body = value; }
        public bool HasStarted => _inner.HasStarted;
        public void OnStarting(Func<object, Task> callback, object state) => _inner.OnStarting(callback, state);
        public void OnCompleted(Func<object, Task> callback, object state) => _inner.OnCompleted(callback, state);
    }
}

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