C# HttpClient.GetAsync选择性丢失查询参数问题排查

这个问题的核心是HTTP请求行序列化时的非法字符截断，和参数名、参数顺序无关，触发逻辑完全匹配你观察到的现象：

• 你手动拼接查询串时用Uri.EscapeDataString把name中的空格转义为%20，在自定义消息处理器中查看RequestUri属性时，Uri对象的字符串表示是正确的
• 但默认HTTP消息处理器在最终序列化HTTP请求行时，会隐式将已经转义的%20反转义为原生空格字符
• 而HTTP协议规定请求行（GET [请求URI] HTTP/版本号）中不允许存在未转义的空格，服务端解析请求时，碰到第一个未转义空格就会判定URI部分结束，空格后的所有查询参数会被直接截断丢弃
• 这就解释了为什么name不带空格时参数完整、带空格时固定丢失后续参数：你之前误以为是o=data参数特殊，只是因为这个参数刚好排在q参数的后面。

你可以通过抓包工具直接查看实际发出的请求行验证这个结论：带空格的name发起请求时，请求行中q参数的空格位置后会直接拼接HTTP/1.1，完全没有后续参数的内容。

可落地方案 #

按优先级推荐以下解决方式，全部可以彻底规避该问题：

• 优先使用官方API构造查询字符串，完全避免手动拼接
  不要自己做转义、拼查询串，用内置的查询参数处理类自动完成合规转义，从根源避免转义不一致问题：

  using System.Web;
  
  static readonly HttpClient client = new() { BaseAddress = new("https://www.jusbrasil.com.br/diarios/busca") };
  
  public static async Task<ResultDocument[]> GetResults(string name)
  {
      // 初始化查询参数集合，内部自动处理所有特殊字符转义
      var query = HttpUtility.ParseQueryString(string.Empty);
      query["q"] = name;
      query["o"] = "data";
      // 拼接生成合法请求URI
      var requestUri = new Uri(client.BaseAddress, "?" + query.ToString());
      var resp = await client.GetAsync(requestUri);
      // 后续解析逻辑
  }
  

  如果是.NET Core 2.1+/NET 5+版本，也可以用Microsoft.AspNetCore.WebUtilities.QueryHelpers类构造查询串，效果一致。

• 替换默认HTTP处理器为托管实现的SocketsHttpHandler（.NET Core 3.0+可用）
  默认HTTP处理器依赖系统原生HTTP栈（Windows下是WinHTTP、Linux下是libcurl），不同平台的隐式转义逻辑不可控，换成纯托管实现的SocketsHttpHandler可以完全控制URI序列化逻辑，不会出现隐式反转义问题：

  // 初始化时指定使用SocketsHttpHandler
  static readonly HttpClient client = new(new SocketsHttpHandler()) 
  { 
      BaseAddress = new("https://www.jusbrasil.com.br/diarios/busca") 
  };
  

避坑提醒 #

不要依赖手动调用Uri.EscapeDataString/Uri.EscapeUriString拼接查询串：Uri类本身存在多层隐式规范化、转义/反转义逻辑，不同.NET版本、不同平台的行为存在差异，手动拼接非常容易触发这类难以排查的参数丢失问题。

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