C# HttpClient设置请求头实现REST API授权失败问题求助

常见错误原因及修复方案 #

1. 请求头重复添加导致校验失败

你当前把自定义请求头的添加逻辑写在了BaseRepository的实例构造函数中，而_httpClient是静态变量，全局唯一。每次你new一个BaseRepository实例时，都会重复执行Add方法添加相同的请求头，最终请求头中会出现多个X-AppSecretToken、X-AgreementGrantToken字段，服务端解析身份信息时出错。
Postman每次请求只会添加一次请求头，所以可以正常调用。

修复代码：

把请求头初始化逻辑放到静态构造函数中，保证全局只执行一次：

private static HttpClient _httpClient = new() { Timeout = new TimeSpan(0, 10, 0) };

// 静态构造函数，全局仅执行一次
static BaseRepository()
{
    _httpClient.DefaultRequestHeaders.Add("X-AppSecretToken", "xxx");
    _httpClient.DefaultRequestHeaders.Add("X-AgreementGrantToken", "xxx");
    _httpClient.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
}

public BaseRepository()
{
    // 实例构造函数中不要操作静态HttpClient的默认请求头
}

2. 请求元数据不匹配

• 你当前只配置了Accept请求头（标识你期望接收的返回数据格式），如果是POST/PUT等带请求体的请求，还需要给请求体设置正确的Content-Type，示例：

  // 发送JSON请求示例
  var json = JsonSerializer.Serialize(你的请求参数对象);
  var content = new StringContent(json, Encoding.UTF8, "application/json");
  var response = await _httpClient.PostAsync("你的接口地址", content);
  

• 部分服务端会校验User-Agent请求头，Postman会默认携带，HttpClient默认无该字段，可手动添加：

  _httpClient.DefaultRequestHeaders.Add("User-Agent", "PostmanRuntime/7.29.0");
  

3. 通用排查方案

直接用抓包工具（Fiddler、Charles等）分别抓取Postman和C#代码发出的请求，逐行对比请求URL、请求头、请求体的差异，修改C#代码和Postman请求完全一致即可解决99%的同类问题。

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