SuperAPI AI 工具集

httpclient-factory

通用与其它

查看项目

更新于 10-15 19:51

技能介绍

用途:指导在 .NET 10 应用中正确使用 IHttpClientFactory 管理 HttpClient 生命周期,避免每次请求 new HttpClient 导致的套接字耗尽与 DNS 变更失效问题。

主要能力:介绍命名客户端、类型化客户端与键控客户端(.NET 10 推荐 AddAsKeyed(),可直接注入、无需字符串查找);通过 AddStandardResilienceHandler() 一行启用限流、总超时、重试(指数退避加抖动)、熔断与单次尝试超时等策略,并可配置重试次数、延迟与超时,或用 DisableForUnsafeHttpMethods() 对非幂等方法禁用重试;用 DelegatingHandler 统一处理认证令牌注入与关联 ID 传播;用 UseSocketsHttpHandler 配置连接池生命周期、空闲超时、每服务器最大连接数与自动解压;测试时可用自定义 HttpMessageHandler 模拟响应。

使用方式:在服务注册中调用 AddHttpClient 配置 BaseAddress 与请求头,再链式添加弹性处理与消息处理器;键控客户端可通过 [FromKeyedServices("name")] 直接注入,或用 ConfigureHttpClientDefaults 全局启用。

适用场景:调用外部 API、需要弹性与认证的统一 HTTP 管道、单例服务中安全使用 HttpClient、集成测试。

限制与注意:不要在单例中捕获类型化客户端,否则会破坏处理器轮换;不要修改共享客户端的 DefaultRequestHeaders(非线程安全);始终传递 CancellationToken;不要叠加多个弹性处理器。资料未提供具体版本兼容范围、性能数据或收费信息。