使用HttpWebRequest调用C# API失败但Postman正常的问题排查

这种情况我碰到过好多次，大概率是你的代码和Postman的请求细节没对齐，我给你列几个最容易遗漏的点，你挨个排查下：

• 请求头没完全匹配
  Postman里默认会带一堆请求头（比如User-Agent、Accept，还有接口要求的Authorization、自定义业务头），很多人写代码时只加了Content-Type就完事了，漏了关键头就会触发服务器内部错误。比如如果接口要求认证令牌，你代码里没加Authorization: Bearer xxx，服务器处理时就可能抛出未授权相关的异常，返回500。
  正确设置头的示例：

  var client = new HttpClient();
  // 添加认证头
  client.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue("Bearer", "your_token_here");
  // 指定接受JSON格式
  client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
  

• 请求体格式或序列化有问题
  Postman里你可能用了Raw JSON格式提交数据，但代码里要么没正确序列化对象，要么用错了Content-Type。比如你用FormUrlEncodedContent提交JSON数据，或者序列化时漏了服务器要求的必填字段，服务器解析请求体失败就会返回500。
  正确序列化JSON请求体的示例：

  var requestModel = new { Name = "test", Age = 20 };
  var json = JsonConvert.SerializeObject(requestModel);
  var content = new StringContent(json, Encoding.UTF8, "application/json");
  var response = await client.PostAsync("your_api_url", content);
  

• 没携带必要的Cookie/会话信息
  有些接口依赖Postman中保存的登录Cookie（比如你之前在Postman里登录过，Cookie自动保存了），但你的.NET代码里的HttpClient是全新的会话，没有这些Cookie，服务器无法识别用户身份，就可能抛出异常。这时候需要手动添加Cookie容器：

  var handler = new HttpClientHandler();
  handler.CookieContainer = new CookieContainer();
  // 把Postman里的Cookie复制过来
  handler.CookieContainer.Add(new Uri("your_api_url"), new Cookie("session_id", "your_session_value"));
  var client = new HttpClient(handler);
  

• HTTPS证书验证问题
  Postman默认会忽略一些HTTPS证书错误（比如自签名证书），但.NET Core 2.0的HttpClient默认会严格验证证书。如果目标服务器用的是自签名证书，代码里没处理的话，请求会失败甚至返回500。开发环境可以临时关闭验证（生产环境绝对不能这么做）：

  var handler = new HttpClientHandler();
  handler.ServerCertificateCustomValidationCallback = (sender, cert, chain, sslPolicyErrors) => true;
  var client = new HttpClient(handler);
  

• 请求方法/URL拼接错误
  别小看这个低级错误！比如Postman用的是POST请求，你代码里写成了GET；或者URL里的路径参数、查询参数没拼对（比如漏了某个参数，或者参数值有拼写错误），导致服务器找不到对应的路由，内部处理出错返回500。

• 一定要看服务器返回的错误详情
  最有效的排查方法是获取服务器返回的具体错误内容，而不是只看状态码500。你可以在代码里加一行：

  var errorContent = await response.Content.ReadAsStringAsync();
  Console.WriteLine(errorContent);
  

  这行代码会把服务器返回的错误信息（比如异常堆栈、错误提示）打印出来，直接告诉你问题出在哪。另外也可以在.NET Core项目里开启Debug级别的日志，看看请求的完整细节。

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