getfromjsonasync()适合标准json反序列化，需注意字段名匹配和多余字段；非json响应或需检查状态码时用getasync+readasstringasync()；查询参数须用queryhelpers或uribuilder编码；httpclient应复用而非每次新建，并设置超时。
HttpClient.GetFromJsonAsync 适合直接反序列化 JSON 响应
如果目标接口返回标准 JSON，且你已有对应类型（比如 User 类），GetFromJsonAsync<t>()</t> 是最简方式。它内部自动处理 Content-Type 检查、UTF-8 解码和 System.Text.Json 反序列化。
常见错误：传入的类型字段名与 JSON key 不匹配（默认区分大小写），或 JSON 含多余字段导致反序列化失败。可配置 JsonSerializerOptions.PropertyNameCaseInsensitive = true 缓解前者。
示例：
var client = new HttpClient();
var user = await client.GetFromJsonAsync<User>("https://api.example.com/user/123");HttpClient.GetAsync + ReadAsStringAsync 用于调试或非 JSON 响应
当接口返回纯文本、HTML、XML，或你需要先检查状态码/响应头再决定是否读取内容时，应拆开调用 GetAsync() 和 ReadAsStringAsync()。直接调用 GetFromJsonAsync 在非 2xx 状态下会抛 HttpRequestException，而 GetAsync 只负责发请求，不强制读取。
注意点：
-
HttpResponseMessage.IsSuccessStatusCode必须显式判断，不能只靠 try-catch -
ReadAsStringAsync()默认使用响应头中的charset，若缺失则 fallback 到 UTF-8；但某些老旧 API 返回 ISO-8859-1 却不声明，需手动读取HttpContent.ReadAsByteArrayAsync再按需解码 - 未释放
HttpResponseMessage或其Content可能导致连接池耗尽（尤其高频调用）
GET 请求带查询参数要用 UriBuilder 或 QueryHelpers
手拼 URL 字符串极易出错：中文或特殊字符未编码、& 和 = 被当分隔符、空格变 + 导致后端解析失败。C# 提供两种安全方式：
推荐 Microsoft.AspNetCore.WebUtilities.QueryHelpers（.NET Core 3.0+ / .NET 5+ 自带）：
var query = QueryHelpers.AddQueryString("https://api.example.com/search",
new Dictionary<string, string> { ["q"] = "c# httpclient", ["page"] = "1" });或用 UriBuilder（全平台兼容）：
var builder = new UriBuilder("https://api.example.com/search") {
Query = $"q={Uri.EscapeDataString("c# httpclient")}&page=1"
};避免直接字符串插值："?q=" + keyword —— 关键字含 & 就会破坏整个查询串结构。
HttpClient 实例必须复用，不要每次 new
频繁创建 HttpClient 实例会导致 socket 耗尽（表现为 SocketException: Too many open files 或 DNS 超时），因为每个实例默认独占一个连接池。正确做法是全局单例或通过 IHttpClientFactory（ASP.NET Core 推荐）管理。
典型误用：
public async Task<string> GetData() {
using var client = new HttpClient(); // ❌ 错误：每次调用都新建
return await client.GetStringAsync("...");
}正确方式（控制台或简单场景）：
private static readonly HttpClient _client = new HttpClient(); // ✅ 静态只读
复杂应用中，依赖注入容器注册 AddHttpClient 才能自动处理生命周期、重试、超时和日志。
超时设置容易被忽略：默认无超时（挂起请求永不返回），务必设 client.Timeout = TimeSpan.FromSeconds(10) 或用 CancellationToken 控制。
