ASP.NET Core项目Serilog在UseSerilog配置内日志丢失问题求助

问题背景 #

ASP.NET Core 项目中使用 Serilog 进行日志记录，初始通过CreateBootstrapLogger()创建引导日志器，UseSerilog()调用前及配置完成后的日志均能正常输出，但写在UseSerilog()配置委托内部的警告日志无法打印，同代码块内的Console.WriteLine却能正常执行。

已尝试无效操作 #

• 在日志语句后添加Task.Delay(5000)、Thread.Sleep(5000)等待日志输出
• 日志输出后立即调用Log.CloseAndFlush()
• 替换CreateBootstrapLogger()为常规CreateLogger()初始化

已排查结论 #

• 在UseSerilog()重载中设置preserveStaticLogger参数为true时日志可正常输出，但会产生两个独立日志器实例，存在资源泄漏、日志重复记录等潜在副作用
• 移除Async sink配置后，Console sink可正常输出该日志（无需设置preserveStaticLogger），但File sink仍丢失该日志，根因是sink未正常刷新，属于serilog-extensions-hosting包的已知实现问题

无副作用可行解决方案 #

方案1：配置委托内使用临时本地日志器输出配置期日志 #

在UseSerilog的配置委托内部，不使用全局静态Log类输出日志，先构建一个和最终配置一致的临时日志器，输出配置过程日志后立即销毁刷入，不会影响全局日志器的生命周期，无多余实例残留。代码示例：

builder.Host.UseSerilog((context, config) => 
{
    // 构建临时日志器，sink配置和最终日志器保持一致
    var tempConfigLogger = new LoggerConfiguration()
        .Enrich.FromLogContext()
        .WriteTo.Console()
        .WriteTo.File("logs/app-.log", rollingInterval: RollingInterval.Day)
        .CreateLogger();

    // 配置逻辑执行，需要输出日志时调用临时日志器
    if (!context.Configuration.GetSection("Serilog").Exists())
    {
        tempConfigLogger.Warning("未检测到Serilog自定义配置，将启用默认日志规则");
    }

    // 销毁临时日志器，强制刷入所有缓冲日志
    tempConfigLogger.Dispose();

    // 后续正常配置全局日志器即可
    config.ReadFrom.Configuration(context.Configuration)
          .Enrich.FromLogContext();
});

方案2：显式关闭sink缓冲并开启自动刷新 #

给所有sink关闭缓冲，Async包装器显式开启自动刷新，配置过程的日志会立即写入，无需等待批量触发：

// Serilog全局配置示例
Log.Logger = new LoggerConfiguration()
    .Enrich.FromLogContext()
    // Async包装器开启autoFlush
    .WriteTo.Async(a => 
    {
        a.Console();
        // File sink关闭buffered
        a.File("logs/app-.log", rollingInterval: RollingInterval.Day, buffered: false);
    }, autoFlush: true)
    .CreateBootstrapLogger();

该方案无需修改配置委托内的日志调用逻辑，适合配置期日志量较小的场景，无额外副作用。

方案3：缓存配置期日志初始化完成后统一写入 #

如果配置过程需要输出的日志较多，可以先把日志内容存到本地队列，等UseSerilog执行完成、全局日志器初始化完毕后，遍历队列统一输出，完全规避配置期日志的sink刷新问题。

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