为何HttpClient的HttpRequestHeaderCollection.Append()方法无法正常工作？

首先明确：Append()的行为和你理解的完全不一样——它不是给同一个请求头追加值，而是尝试添加一个全新的同名请求头条目，但HTTP协议的规则和HttpClient的处理逻辑，导致大部分场景下你看不到预期的效果。

你的测试为什么不符合预期？ #

1. 直接Append多值头没出现 #

你执行client.DefaultRequestHeaders.Append(new("x-tra", ["nice", "cozy"]))后没看到请求头，大概率是测试时的取值方式有问题。实际上这个操作已经把x-tra头添加到集合里了，只是自定义头默认会被合并为单个条目，多个值用逗号分隔。如果你用client.DefaultRequestHeaders.GetValues("x-tra")遍历，会看到两个值都存在。

2. 先Add再Append只看到第一个值 #

同样，这不是Append没生效，而是HttpClient把同名称的自定义头合并了。你添加的cool和cozy其实已经被追加到x-tra头的取值集合里了，只是如果你只取第一个值（比如GetValues("x-tra").First()），自然看不到后续的值。

Append()的实际用途是什么？ #

Append()并不是没用，但它的适用场景非常窄——只有当HTTP协议明确允许多个独立的同名请求头条目时，它才会发挥作用。最典型的例子是Set-Cookie头：每个Cookie需要作为单独的Set-Cookie条目发送，不能合并成逗号分隔的单一条目。这时候用Append()就能添加多个独立的头：

client.DefaultRequestHeaders.Append(new HttpRequestHeader("Set-Cookie", "cookie1=value1; Path=/"));
client.DefaultRequestHeaders.Append(new HttpRequestHeader("Set-Cookie", "cookie2=value2; Path=/"));

此时发送请求时，会出现两个独立的Set-Cookie头，而不是合并成一个。

正确的多值请求头添加方式 #

对于绝大多数场景（包括自定义头），如果你想给同一个头添加多个值，直接用Add()方法即可：

// 多次添加单个值
client.DefaultRequestHeaders.Add("x-tra", "nice");
client.DefaultRequestHeaders.Add("x-tra", "cool");
client.DefaultRequestHeaders.Add("x-tra", "cozy");

// 或者一次添加多个值
client.DefaultRequestHeaders.Add("x-tra", new[] {"nice", "cool", "cozy"});

发送请求时，HttpClient会自动把这些值合并为x-tra: nice,cool,cozy的格式，符合HTTP协议规范。

为什么博客都只提Add()？ #

因为Append()的适用场景太特殊了，99%的日常开发场景用Add()就足够处理所有请求头的添加需求，包括多值场景。所以大部分技术博客不会特意提到这个小众方法。

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