.NET Core使用HttpClient GetAsync请求返回JSON结构异常问题求助

必做前置校验 #

首先优先确认响应本身差异还是反序列化错误：
在两个项目中都执行以下代码输出原始信息，直接对比结果：

// 输出请求完整地址
Console.WriteLine(requestMessage.RequestUri?.AbsoluteUri);
// 输出所有请求头
foreach (var header in client.DefaultRequestHeaders.Concat(requestMessage.Headers))
{
    Console.WriteLine($"{header.Key}: {string.Join(",", header.Value)}");
}
// 输出原始响应字符串，不要经过任何反序列化
var rawResponse = await response.Content.ReadAsStringAsync();
Console.WriteLine(rawResponse);

如果原始响应内容完全一致，说明是现有项目的反序列化配置错误；如果原始响应内容不同，说明是请求环节存在差异。

分场景排查与解决方案 #

场景1：原始响应内容不同（请求环节差异） #

• 排查HttpClient全局配置：
  检查现有项目是否通过IHttpClientFactory注册了全局委托处理器（DelegatingHandler），有没有被中间件篡改请求路径、请求头、查询参数。可以直接手动实例化一个全新的HttpClient（不使用项目中注入的实例）发起请求验证。
• 排查请求头差异：
  重点对比Accept、Accept-Encoding、User-Agent三个请求头：
  1. 部分接口会根据Accept返回不同结构的响应，确保现有项目的Accept头设置为application/json
  2. 未开启响应解压会导致压缩后的响应读取为乱码，从而出现…_price这类异常属性名，开启自动解压配置即可：

  var handler = new HttpClientHandler
  {
      AutomaticDecompression = DecompressionMethods.GZip | DecompressionMethods.Deflate | DecompressionMethods.Brotli
  };
  var client = new HttpClient(handler);
  

• 排查请求地址拼接错误：
  检查现有项目是否配置了BaseAddress，拼接请求路径时是否出现多斜杠、漏参数、参数编码错误的问题。

场景2：原始响应内容一致（反序列化配置错误） #

• 检查JSON序列化全局配置：
  1. 若使用Newtonsoft.Json：检查是否全局设置了自定义的NamingStrategy、ContractResolver，或者MissingMemberHandling、MetadataPropertyHandling等配置干扰了属性映射。
  2. 若使用System.Text.Json：检查JsonSerializerOptions中的PropertyNameCaseInsensitive、PropertyNamingPolicy等配置是否和新项目一致。
• 检查是否有自定义JsonConverter全局注册：
  现有项目如果注册了全局自定义JsonConverter，可能会对匹配的类型强行修改反序列化逻辑，导致结构解析错误。

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