.NET 6中为指定命名Refit客户端覆写日志并保持HttpClient名称唯一

核心问题拆解 #

需要同时满足两个要求：

• 为每个Refit客户端配置唯一的HttpClient名称（符合命名客户端的唯一性约束）
• 让System.Net.Http.HttpClient.SdkNameOfMyProject的日志配置（关闭日志）对这些客户端生效

解决方案一：通配符日志配置 + 分组唯一命名 #

这种方式适合批量管理同属一个业务组的Refit客户端，只需调整日志配置的分类匹配规则，同时给客户端命名时带上统一前缀。

1. 修改appsettings.json的日志配置，使用通配符匹配所有以SdkNameOfMyProject开头的客户端：

"Logging": {
  "LogLevel": {
    "Default": "Information",
    "System.Net.Http.HttpClient.SdkNameOfMyProject*": "None"
  }
}

2. 注册Refit客户端时，使用带统一前缀的唯一名称：

// 订单服务Refit客户端，唯一名称：SdkNameOfMyProject-OrderService
builder.Services.AddRefitClient<IOrderApi>()
    .ConfigureHttpClient(client => client.BaseAddress = new Uri("https://api.example.com/orders"))
    .NamedClient("SdkNameOfMyProject-OrderService");

// 商品服务Refit客户端，唯一名称：SdkNameOfMyProject-ProductService
builder.Services.AddRefitClient<IProductApi>()
    .ConfigureHttpClient(client => client.BaseAddress = new Uri("https://api.example.com/products"))
    .NamedClient("SdkNameOfMyProject-ProductService");

所有带SdkNameOfMyProject前缀的唯一命名客户端，都会自动匹配日志规则，关闭HTTP请求日志。

解决方案二：手动指定日志分类，脱离客户端名称约束 #

如果需要完全独立控制每个客户端的日志分类，不受命名规则限制，可以在注册时手动指定日志筛选规则，直接命中目标配置。

注册Refit客户端时，通过ConfigureLogging强制绑定目标日志分类：

// 注册唯一命名的HttpClient，并绑定目标日志分类
builder.Services.AddHttpClient("Unique-Order-Client", client =>
{
    client.BaseAddress = new Uri("https://api.example.com/orders");
})
.AddTypedClient(Refit.RestService.For<IOrderApi>)
.ConfigureLogging(logging =>
{
    // 添加筛选规则，直接应用System.Net.Http.HttpClient.SdkNameOfMyProject的配置
    logging.AddFilter("System.Net.Http.HttpClient.SdkNameOfMyProject", LogLevel.None);
});

// 同理注册另一个唯一客户端
builder.Services.AddHttpClient("Unique-Product-Client", client =>
{
    client.BaseAddress = new Uri("https://api.example.com/products");
})
.AddTypedClient(Refit.RestService.For<IProductApi>)
.ConfigureLogging(logging =>
{
    logging.AddFilter("System.Net.Http.HttpClient.SdkNameOfMyProject", LogLevel.None);
});

这种方式下，客户端名称可以任意设置（保证唯一即可），日志规则直接通过代码绑定到目标分类，完全匹配原有的appsettings配置。

解决方案三：全局日志筛选规则 #

通过代码全局配置日志筛选逻辑，根据客户端名称的特征自动应用日志规则：

builder.Logging.AddFilter("System.Net.Http.HttpClient", (category, level) =>
{
    // 匹配所有包含SdkNameOfMyProject的HttpClient日志分类
    if (category.Contains("SdkNameOfMyProject"))
    {
        return level == LogLevel.None;
    }
    // 其他分类使用默认配置
    return true;
});

注册Refit客户端时只需保证名称唯一，无需修改日志配置文件：

builder.Services.AddRefitClient<IOrderApi>()
    .ConfigureHttpClient(client => client.BaseAddress = new Uri("https://api.example.com/orders"))
    .NamedClient("SdkNameOfMyProject-Order-123"); // 唯一名称，包含目标标识

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