如何在.NET Core中设置HttpClient请求的自定义Content-Type？

问题分析 #

1. GET请求带请求体的兼容性问题：虽然HTTP标准不推荐GET请求带请求体，但既然API明确要求，只能适配。
2. 自定义媒体类型的解析问题：直接把带版本参数的完整媒体类型字符串传给StringContent构造函数，HttpClient的解析逻辑可能无法正确识别，导致错误。
3. Content-Type头的正确设置方式：这个头是和请求内容绑定的，不能直接加到默认请求头里，必须通过请求内容的属性来设置。

修正后的代码 #

手动构建MediaTypeHeaderValue对象，明确指定媒体类型和版本参数，再赋值给StringContent的ContentType属性：

_httpClient.BaseAddress = new Uri("http://example.com/");
_httpClient.DefaultRequestHeaders.Add(HeaderNames.Accept, "application/x.example.hr.employee+json;version=1");

List<string> strEmail = new List<string>
{
     employeeEmail
};
var jsonEmail = JsonConvert.SerializeObject(strEmail);

// 构建自定义媒体类型，包含version参数
var customMediaType = new MediaTypeHeaderValue("application/x.example.hr.employee.email+json");
customMediaType.Parameters.Add(new NameValueHeaderValue("version", "1"));

// 先创建StringContent，再手动设置ContentType
var requestContent = new StringContent(jsonEmail, Encoding.UTF8);
requestContent.Headers.ContentType = customMediaType;

var request = new HttpRequestMessage()
{
    Method = HttpMethod.Get,
    RequestUri = new Uri("http://example.com/employees"),
    Content = requestContent
};

// 发送请求并处理响应
var response = await _httpClient.SendAsync(request).ConfigureAwait(false);
// 这里可以添加响应验证、内容读取等逻辑

关键注意点 #

• 绝对不要在DefaultRequestHeaders中设置Content-Type：这个头属于请求内容的一部分，HttpClient会禁止直接在默认头中添加，强行添加会抛出异常。
• 如果后续仍有问题：可以和API提供方确认，是否允许用POST请求替代GET（更符合HTTP规范），或者是否有其他传递邮箱列表的方式（比如查询参数）。

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