C# HttpClient如何添加X-HTTP-METHOD-Override自定义请求头

X-HTTP-Method-Override属于非标准自定义请求头，DefaultRequestHeaders下没有对应的强类型配置属性，直接调用Add方法传入头名和值即可，有两种常用实现方式：

方式1：全局配置（当前HttpClient所有请求自动携带该头） #

如果该客户端发起的所有请求都需要带这个头，直接加到默认请求头集合即可：

using (var client = new HttpClient())
{
    client.BaseAddress = new Uri(BASEURL);
    client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
    client.DefaultRequestHeaders.Authorization = CreateAuthHeader();
    // 添加X-HTTP-Method-Override头，值填你要模拟的HTTP方法
    client.DefaultRequestHeaders.Add("X-HTTP-Method-Override", "PATCH");

    var requestBody = new Dictionary<string, string>
    {
        { "price", price.ToString() }
    };
    var jsonRequest = JsonConvert.SerializeObject(requestBody);
    var content = new StringContent(jsonRequest, Encoding.UTF8, "application/json-patch+json");

    // 注意：X-HTTP-Method-Override常规用法是实际发POST请求，服务端会读取头值做路由匹配
    // 若你的服务端要求实际请求方法为PUT，保留PutAsync即可，按服务端实际规则调整
    var response = await client.PostAsync($"{APIBASE}/data/ProductAttribute/{attributeId}", content).ConfigureAwait(false);
}

方式2：单请求配置（仅指定请求携带该头） #

如果不需要全局加，单独构造HttpRequestMessage给单个请求挂载头即可：

using (var client = new HttpClient())
{
    client.BaseAddress = new Uri(BASEURL);
    client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
    client.DefaultRequestHeaders.Authorization = CreateAuthHeader();

    var requestBody = new Dictionary<string, string>
    {
        { "price", price.ToString() }
    };
    var jsonRequest = JsonConvert.SerializeObject(requestBody);
    var content = new StringContent(jsonRequest, Encoding.UTF8, "application/json-patch+json");

    // 构造请求对象，指定实际发送的HTTP方法
    var request = new HttpRequestMessage(HttpMethod.Post, $"{APIBASE}/data/ProductAttribute/{attributeId}")
    {
        Content = content
    };
    // 仅给当前请求添加自定义头
    request.Headers.Add("X-HTTP-Method-Override", "PATCH");

    var response = await client.SendAsync(request).ConfigureAwait(false);
}

注意事项 #

• 自定义请求头添加时不需要提前做特殊声明，只要头名字符串拼写正确，直接调用Add方法就能生效，添加后可以通过抓包工具确认头是否正确携带。
• 你之前调用PatchAsync不生效，可以顺便排查下请求体格式：标准JSON Patch规范要求请求体是操作数组结构，而非简单的键值对，比如更新price字段的标准Patch格式为[{"op":"replace","path":"/price","value":你的价格值}]，如果服务端要求严格遵循Patch格式，即使加了Override头也会因为格式问题请求失败。
• 部分网关、服务端框架默认会拦截X-HTTP-Method-Override头，如果配置完头还是不生效，可以先确认服务端是否开启了该头的支持。

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