.NET Core自定义日志分类appsettings配置不生效问题排查

手动创建的LoggerFactory加载appsettings配置的正确方式 #

你手动调用LoggerFactory.Create生成的是完全独立的日志工厂实例，和Web宿主启动时在DI容器中注册的ILoggerFactory没有关联，默认不会自动读取appsettings里的Logging节点配置。之前的测试代码只给这个手动创建的工厂加了Console提供程序，没有传入配置规则，日志管道会使用默认的全局过滤阈值Information，自然不会遵循你配置的Error级别规则。
有两种可落地的实现方案：

• 优先直接用DI容器注入的ILoggerFactory实例创建分类日志。宿主初始化阶段已经自动完成了配置绑定、提供程序注册的全流程，拿到的实例默认就遵循appsettings里的所有日志过滤规则，不需要额外写配置代码。
• 如果确实需要脱离DI手动创建日志工厂，必须在构建工厂时显式绑定配置节点，示例代码如下：

var builder = WebApplication.CreateBuilder(args);
// 手动构建日志工厂时传入配置
var manualLoggerFactory = LoggerFactory.Create(logBuilder =>
{
    // 绑定appsettings中Logging节点的所有配置，包括自定义分类的过滤规则
    logBuilder.AddConfiguration(builder.Configuration.GetSection("Logging"));
    // 注册需要使用的日志提供程序
    logBuilder.AddConsole();
});
var logger = manualLoggerFactory.CreateLogger("MyCategoryName");

IsEnabled判断与实际日志输出不一致的原因 #

.NET Core的日志过滤是两层设计，这是出现判断和输出不符的核心原因：

1. 第一层是日志工厂层面的全局过滤：只要当前日志级别满足任意一个已注册日志提供程序的过滤阈值，IsEnabled()方法就会返回true，仅代表这个级别至少会被一个提供程序处理，不代表所有输出渠道都会打印这条日志。
2. 第二层是单个日志提供程序的独立过滤：每个注册的日志提供程序（比如Console、Debug、EventSource等）都可以配置自己独立的过滤规则，不满足当前提供程序阈值的日志会被直接丢弃，不会输出到对应的渠道。
   默认创建的ASP.NET Core项目会自动注册4种日志提供程序：Console控制台提供程序、Debug调试窗口提供程序、EventSource事件源提供程序、Windows环境下的EventLog系统日志提供程序。你第一次运行时看到LogLevel.Warning的IsEnabled返回true但控制台没有输出，本质是因为Debug提供程序默认允许Warning级别日志输出（会打印到VS的调试输出窗口），所以工厂层面判断这个级别是启用的；但你配置的Error级别规则只命中了Console提供程序，Console会把Warning级别的日志过滤掉，你只看控制台输出自然会觉得日志没打出来。
   当你在代码里清除所有默认提供程序、仅保留Console提供程序后，整个日志管道只有一个提供程序，工厂层面的过滤阈值和Console的独立过滤阈值完全一致，IsEnabled的判断结果就会和控制台实际输出完全匹配。

实操提示：如果注册了多个日志提供程序，不要只依赖IsEnabled判断某一个输出渠道的日志是否会打印，配置过滤规则时建议明确指定每个提供程序的阈值，避免出现预期外的日志丢失或多余输出。

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