如何编写通用函数实现HttpContext与HttpRequestMessage/Response的Header互复制？

核心思路 #

两者的核心差异在于值类型：IHeaderDictionary的取值为StringValues（可承载单个或多个字符串的结构），而HttpHeaders的取值为IEnumerable<string>。只需完成这两种值类型的双向转换，再结合键的遍历就能实现头信息的完整复制。

实现代码 #

1. 从IHeaderDictionary复制到HttpHeaders（适用于将HttpContext请求头转发给HttpRequestMessage） #

可以通过静态工具类或扩展方法实现：

public static void CopyHeadersTo(this IHeaderDictionary source, HttpHeaders target)
{
    foreach (var header in source)
    {
        // 跳过无需转发的系统级请求头，可根据业务调整
        if (ShouldSkipRequestHeader(header.Key))
            continue;
            
        // StringValues可直接转为IEnumerable<string>，无需额外处理
        target.TryAddWithoutValidation(header.Key, header.Value);
    }
}

// 辅助方法：过滤不需要转发的请求头
private static bool ShouldSkipRequestHeader(string headerName)
{
    var skipList = new HashSet<string>(StringComparer.OrdinalIgnoreCase)
    {
        "Host",
        "Connection",
        "Content-Length",
        "Transfer-Encoding"
    };
    return skipList.Contains(headerName);
}

2. 从HttpHeaders复制到IHeaderDictionary（适用于将外部响应头同步到HttpContext响应） #

对应的反向复制方法：

public static void CopyHeadersTo(this HttpHeaders source, IHeaderDictionary target)
{
    foreach (var header in source)
    {
        // 将IEnumerable<string>转为StringValues，直接用数组构造即可
        target[header.Key] = new StringValues(header.Value.ToArray());
    }
}

实际使用示例 #

在Web API中的调用方式：

// 1. 把HttpContext请求头复制到HttpRequestMessage
var externalRequest = new HttpRequestMessage(HttpMethod.Post, "https://external-service.example.com/api");
HttpContext.Request.Headers.CopyHeadersTo(externalRequest.Headers);

// 若请求带内容，同步Content头
if (HttpContext.Request.ContentLength.HasValue)
{
    externalRequest.Content = new StreamContent(HttpContext.Request.Body);
    HttpContext.Request.ContentHeaders.CopyHeadersTo(externalRequest.Content.Headers);
}

// 2. 发送请求后，同步外部响应头到HttpContext
var externalResponse = await _httpClient.SendAsync(externalRequest);
externalResponse.Headers.CopyHeadersTo(HttpContext.Response.Headers);
externalResponse.Content.Headers.CopyHeadersTo(HttpContext.Response.ContentHeaders);

关键细节说明 #

• TryAddWithoutValidation：跳过HttpHeaders默认的格式校验，避免自定义头不符合标准时抛出异常；若需严格校验，可替换为Add方法。
• 请求头过滤：部分系统级头（如Host、Connection）由HttpClient自动管理，强行转发可能引发请求错误，建议根据实际场景调整过滤列表。
• 值类型转换：StringValues本身实现了IEnumerable接口，可直接传入HttpHeaders的方法；反之，用数组构造StringValues即可完成反向转换。

内容的提问来源于stack exchange，提问作者Wim ten Brink