Typed Client 是什么，和普通 HttpClient 有什么区别
Typed Client 不是新类型的客户端，而是
IHttpClientFactory提供的一种注册与使用模式：把
HttpClient和它的配置、行为（如重试、认证头）封装进一个强类型类里。它和直接 new
HttpClient()或用
IServiceCollection.AddHttpClient<t>()</t>注册的普通命名客户端不同——后者只配了客户端实例，而 Typed Client 把“用这个客户端干啥”也一并定义在类型中。
关键点在于：Typed Client 类本身不继承
HttpClient，也不持有
HttpClient字段，而是通过构造函数接收
HttpClient实例，由 DI 容器自动注入。这避免了手动管理生命周期，也天然支持依赖注入链中的其他服务（比如
IOptionsMonitor<apisettings></apisettings>）。
如何注册并使用 Typed Client（.NET 6+ 推荐写法）
在
Program.cs中注册：
builder.Services.AddHttpClient<GitHubService>(client =>
{
client.BaseAddress = new Uri("https://api.github.com/");
client.DefaultRequestHeaders.UserAgent.ParseAdd("MyApp/1.0");
});
对应的服务类定义为：
public class GitHubService
{
private readonly HttpClient _httpClient;
<pre class="brush:php;toolbar:false;">public GitHubService(HttpClient httpClient)
{
_httpClient = httpClient;
}
public async Task<string> GetRepoNameAsync(string owner, string repo)
{
var response = await _httpClient.GetAsync($"repos/{owner}/{repo}");
response.EnsureSuccessStatusCode();
return await response.Content.ReadAsStringAsync();
}}
注意：
GitHubService不需要标记
[ServiceContract]或继承任何基类 构造函数参数必须是
HttpClient，不能是
IHttpClientFactory或其他变体 注册时泛型参数
<githubservice></githubservice>必须和类名完全一致，否则 DI 无法解析
为什么不能在 Typed Client 里 new HttpClient
常见错误是这样写：
public class BadService
{
private readonly HttpClient _client = new HttpClient(); // ❌ 错误！
// ...
}
这会导致：
绕过IHttpClientFactory的连接池复用和 DNS 刷新机制 没有内置的 Polly 策略（如超时、重试）支持 无法利用工厂提供的日志、指标、命名隔离等能力 在高并发下容易触发
SocketException: Too many open files（尤其 Linux 容器环境）
Typed Client 的核心价值，就是让
HttpClient实例的创建、配置、销毁全部交由工厂统一管控，业务类只专注逻辑。
多个 Typed Client 共享同一组配置？用命名客户端 + 委托注册
如果几个服务都要访问同一个 API 域名，但又希望各自独立类型（比如
OrderService和
InventoryService），可以复用命名配置：
builder.Services.AddHttpClient("internal-api", client =>
{
client.BaseAddress = new Uri(builder.Configuration["InternalApi:BaseUrl"]);
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer", builder.Configuration["InternalApi:Token"]);
});
<p>builder.Services.AddTransient<OrderService>(sp =>
{
var httpClient = sp.GetRequiredService<IHttpClientFactory>()
.CreateClient("internal-api");
return new OrderService(httpClient);
});</p><p>builder.Services.AddTransient<InventoryService>(sp =>
{
var httpClient = sp.GetRequiredService<IHttpClientFactory>()
.CreateClient("internal-api");
return new InventoryService(httpClient);
});
</p>这种方式比重复注册更可控，也便于后期切流或打标监控。
Typed Client 看似简单，真正容易出问题的地方在于：以为“只要构造函数有
HttpClient就算用了工厂”，结果手动 new 了实例，或者混淆了命名客户端与类型化客户端的注册路径。一旦跨服务共享配置或加策略，这些边界就立刻暴露。
