WebApplicationFactory创建的HttpClient处理多值请求头与直接实例化的有差异？

核心差异原因 #

两者的行为差异本质在于请求的传输方式和HTTP协议的序列化处理：

1. 原生new HttpClient()的行为 #

当你通过HttpRequestMessage.Headers.Add添加多值头时，原生HttpClient会遵循HTTP/1.1协议规范，将多个值合并为单个逗号分隔的头字段发送到服务器。比如你的请求头实际会被序列化为：

custom-header: value1, value2

后端接收到的是一个包含两个值的头条目，因此HttpContext.Request.Headers["custom-header"].Count()返回1（这里的Count是指头字段的数量，而非字段内的值数量）。

2. WebApplicationFactory创建的HttpClient行为 #

WebApplicationFactory是在内存中托管测试服务器，请求不会经过真实的HTTP网络传输，而是直接在进程内传递请求对象的原始集合数据。添加的多值头会被保留为独立的多个头条目传递给后端，因此HttpContext.Request.Headers["custom-header"].Count()返回2。

验证与最佳实践 #

• 用抓包工具（如Fiddler）查看原生HttpClient的请求，能看到合并后的单条头字段；WebApplicationFactory的请求无网络传输，直接传递原始头集合。
• 后端处理头字段时，更可靠的方式是获取所有值的数量，而非依赖头字段的数量：

  return HttpContext.Request.Headers["custom-header"].GetValues().Count();
  

  这样无论头是合并为单个字段还是多个条目，都能得到正确的数值数量（2）。

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