HttpClient应作为单例复用，避免频繁创建导致端口耗尽、DNS缓存失效；IHttpClientFactory通过PooledConnectionLifetime解决DNS变更不生效；401/403等状态码不抛异常，需调用EnsureSuccessStatusCode校验；[FromBody]绑定失败主因是Content-Type缺失、模型无参构造函数或不可空字段验证失败。
HttpClient 实例复用为什么不能每次 new
频繁创建 HttpClient 实例会导致端口耗尽、DNS 缓存失效、连接无法复用，尤其在高并发场景下容易触发 SocketException: Too many open files 或 HttpRequestException: Connection refused。.NET 官方明确建议将其作为单例或静态成员长期持有。
- ✅ 正确做法：在 Startup.cs（.NET 5+ 为 Program.cs）中注册为单例：
services.AddSingleton<httpclient>()</httpclient>，或使用IHttpClientFactory - ⚠️ 错误写法：
var client = new HttpClient();放在方法体内，尤其在循环或高频 API 调用中 - ? 补充：直接 new
HttpClient时若未显式调用Dispose()，也可能延迟释放底层 socket；而IHttpClientFactory自动管理生命周期和连接池
IHttpClientFactory 如何避免 DNS 变更不生效
IHttpClientFactory 默认启用连接池复用，但 DNS 记录变更（如负载均衡切换、服务 IP 更新）后，旧连接可能持续复用数分钟，导致请求发往已下线节点。这不是 bug，而是 HTTP/1.1 连接复用的副作用。
- ✅ 解决方案：配置
PooledConnectionLifetime，强制定期重建连接池，例如设置为 2 分钟：services.AddHttpClient("MyApi") .ConfigurePrimaryHttpMessageHandler(() => new SocketsHttpHandler { PooledConnectionLifetime = TimeSpan.FromMinutes(2) }); - ⚠️ 注意：不要设为
TimeSpan.Zero，这等于禁用连接池，性能下降明显；也不要设为过长（如 30 分钟），不利于故障转移 - ? 场景提示：该问题在 Kubernetes 中滚动更新 WebAPI 后特别常见，客户端若未及时刷新连接，会持续报
502 Bad Gateway或超时
WebAPI 返回 401/403 时，HttpClient 不抛异常？
HttpClient.SendAsync() 默认只在网络层失败（如超时、拒绝连接）时抛异常，HTTP 状态码如 401 Unauthorized、403 Forbidden、404 Not Found 都算“成功响应”，不会触发异常 —— 这是设计使然，不是 bug。
- ✅ 推荐做法：调用
response.EnsureSuccessStatusCode()显式检查状态码，它会在非 2xx 时抛HttpRequestException - ⚠️ 坑点：若用
await client.GetAsync(url)后直接读取response.Content.ReadAsStringAsync()，却忽略response.IsSuccessStatusCode，可能把错误响应体当正常数据解析，导致 JSON 反序列化失败 - ? 小技巧：可封装通用请求方法，在返回前统一校验状态码，并根据业务需要补充日志或重试逻辑
FromBody 参数绑定失败的三个典型原因
WebAPI Controller 中 [FromBody] 绑定失败，常见现象是参数为 null，即使前端明确发送了 JSON。根本原因往往不在代码逻辑，而在内容协商或序列化配置。
- ✅ 必须满足：请求头含
Content-Type: application/json；否则 MVC 默认不尝试 JSON 反序列化 - ✅ 模型需有无参构造函数，且属性为 public set；若用 record 或 init-only 属性，需确认目标框架版本（.NET 6+ 支持 record 绑定，但需启用
JsonSerializerOptions.IncludeFields = true等） - ⚠️ 常见疏漏：前端用
JSON.stringify({})发送空对象，但后端模型有不可为空的值类型字段（如int Id），此时模型验证失败，ModelState.IsValid为 false，且默认不返回详细错误（除非开启SuppressModelStateInvalidFilter）
ModelState，最后看日志里有没有 JsonSerializer 抛出的内部异常 —— 很多绑定失败其实在中间件里静默吞掉了。 
