ASP.NET Core 3.1中Serilog控制器内日志不输出问题排查
问题根源
你遇到的输出差异,本质是ASP.NET Core 3.1环境下Serilog的默认Host扩展逻辑触发的日志器替换问题,具体触发逻辑如下:
- 你在Main方法中手动构建了一套带Console输出、机器名增强的完整Serilog日志器,赋值给全局
Log.Logger,这个实例是可以正常输出日志的。 - 当你调用无参的
.UseSerilog()方法时,Serilog.Hosting扩展的默认参数preserveStaticLogger = false会在Host启动的最后阶段,完全替换你手动创建的全局Log.Logger,用从Host内置配置重新构建的新日志器替代。 - 这个被替换上来的新日志器,只会从你的appsettings.json中读取
MinimumLevel相关的配置,但不会继承你在Main方法中用代码手动添加的WriteTo.Console()、自定义增强逻辑等配置——因为你的appsettings.json里根本没有配置任何输出Sink,所以这个新日志器是没有任何实际输出能力的。 - 输出差异的来源就很好解释了:
- 启动阶段的日志(比如"Application Starting."、Startup类初始化阶段的日志)、请求日志中间件的输出,都是在Host完成容器构建、替换全局日志器的阶段边界之前完成写入的,走的还是你一开始创建的带Console输出的旧日志器,所以完全正常。
- 控制器是收到请求时才通过DI实例化的,这时候全局日志器早就被替换成没有输出能力的新实例了,控制器里通过注入的
ILogger<T>写入的日志,自然就没有任何输出。
修复方案
针对现有代码结构,可以选择两种适配方式:
- 快捷兼容现有代码的方案:给
.UseSerilog()加上preserveStaticLogger: true参数,告诉Serilog不要替换你在Main中手动创建的全局日志器,直接保留原实例给DI容器使用。修改后的代码片段:public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .UseSerilog(preserveStaticLogger: true) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); }); - 更符合Serilog与ASP.NET Core集成规范的方案:去掉Program里手写静态Configuration、手动创建全局Log.Logger的冗余逻辑,把日志配置完全托管给Host的配置管线,从根源上避免两套配置不一致的问题。具体调整:
- 移除Program中静态定义的
_configuration属性、Main方法里手动构建Log.Logger的重复代码 - 在
CreateHostBuilder的UseSerilog回调里统一完成所有日志配置:public static IHostBuilder CreateHostBuilder(string[] args) => Host.CreateDefaultBuilder(args) .UseSerilog((hostContext, loggerConfig) => { loggerConfig.ReadFrom.Configuration(hostContext.Configuration) .Enrich.WithMachineName() .Enrich.FromLogContext() .WriteTo.Console(); }) .ConfigureWebHostDefaults(webBuilder => { webBuilder.UseStartup<Startup>(); });
- 移除Program中静态定义的
这种写法不需要手动维护配置加载逻辑,所有日志配置和Host的内置配置管线完全打通,也不会出现日志器被静默替换的问题。
内容的提问来源于stack exchange,提问作者shivam-sharma
相关产品推荐
相关产品推荐

