.NET Core Kestrel响应头自动转为小写问题的解决方案咨询

我之前也碰到过一模一样的情况，其实核心原因就是Kestrel服务器在处理HTTP/2请求时，会自动按照HTTP/2规范把所有响应头转换成小写——哪怕你在代码里写的是驼峰或 PascalCase 格式。而你之前用的context.Response.Headers其实是经过Kestrel包装的上层API，最后还是会被它的转换逻辑覆盖，所以直接移除再添加也没用。

下面给你几个可行的解决办法，按优先级排序：

1. 使用底层IHttpResponseFeature操作响应头 #

这是最直接有效的方法，因为IHttpResponseFeature是ASP.NET Core管道里的底层特性，直接操作它的Headers集合可以绕过Kestrel的自动小写转换逻辑。修改你的中间件代码如下：

app.Use(next => async context => {
    var stopWatch = new Stopwatch();
    stopWatch.Start();
    
    context.Response.OnStarting(() => {
        stopWatch.Stop();
        // 获取底层响应头特性
        var responseFeature = context.Features.Get<IHttpResponseFeature>();
        if (responseFeature != null)
        {
            // 先移除已存在的同名头（避免重复）
            responseFeature.Headers.Remove("X-ResponseTime-Ms");
            // 添加自定义头，这里的大小写会被完整保留
            responseFeature.Headers.Add("X-ResponseTime-Ms", stopWatch.ElapsedMilliseconds.ToString());
        }
        return Task.CompletedTask;
    });

    await next(context);
});

这个方法的原理是：context.Response.Headers是Kestrel提供的封装层，会自动应用HTTP/2的头格式规则；而IHttpResponseFeature直接对应原始的响应头数据，Kestrel不会对它做额外的大小写转换。

2. 检查OpenShift路由/代理的配置 #

如果上面的方法还是没生效，那可能是OpenShift的路由代理（比如默认的HAProxy）在转发请求时修改了响应头。这时候你需要在OpenShift的Route资源里添加注解，禁止代理修改头的大小写：

比如在Route的YAML配置里添加：

metadata:
  annotations:
    haproxy.router.openshift.io/haproxy-config-backend: "http-response set-header X-ResponseTime-Ms %[res.hdr(X-ResponseTime-Ms)]"

这个注解的作用是让HAProxy原样保留后端返回的X-ResponseTime-Ms头，不做任何大小写转换。

3. 针对特定头配置Kestrel（.NET 5+） #

如果你用的是.NET 5或更高版本，还可以直接在Kestrel的配置里指定允许保留大小写的响应头。在Program.cs（或Startup.cs）里添加：

builder.WebHost.ConfigureKestrel(options =>
{
    options.AllowResponseHeaderNames("X-ResponseTime-Ms");
});

这个配置会告诉Kestrel，对于指定的头不要自动转换为小写，保持你设置的原始格式。

需要注意的是：HTTP/2规范本身其实不强制要求头小写，只是推荐这么做（因为HTTP/2的头是二进制编码，小写更高效）。但如果你的客户端确实依赖特定的头大小写，上面的方法都能解决问题。

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