使用Serilog时ILogger无法输出日志到控制台的问题求助

核心原因分析 #

启动时直接调用Log.Logger能输出日志，但控制器注入的ILogger<HomeController>无输出，大概率是DI容器使用的Logger配置与启动时的临时Logger不一致，或是Serilog相关依赖包缺失、Async接收器配置存在缓冲延迟。

解决方案步骤 #

1. 确认安装所有必要NuGet包 #

确保项目已安装以下包（可通过NuGet包管理器或CLI安装）：

Install-Package Serilog.AspNetCore
Install-Package Serilog.Sinks.Console
Install-Package Serilog.Sinks.Async
Install-Package Serilog.Formatting.Compact

2. 统一Logger配置，让DI与启动日志使用同一实例 #

修改Program.cs，让初始Logger和DI容器使用的Logger共享同一配置，避免出现两套独立的Logger实例：

public class Program
{
    public static void Main(string[] args)
    {
        // 先加载配置文件
        var configuration = new ConfigurationBuilder()
            .SetBasePath(Directory.GetCurrentDirectory())
            .AddJsonFile("appsettings.json", optional: false, reloadOnChange: true)
            .Build();

        // 基于配置文件初始化全局Logger
        Log.Logger = new LoggerConfiguration()
            .ReadFrom.Configuration(configuration)
            .CreateLogger();

        try
        {
            Log.Information("Starting up version {version}", Defaults.Version);
            CreateHostBuilder(args).Build().Run();
        }
        catch (Exception ex)
        {
            Log.Fatal(ex, "Application start-up failed");
        }
        finally
        {
            Log.CloseAndFlush();
        }
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .UseSerilog() // 直接使用已初始化的全局Logger，无需重复读取配置
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

3. 排查Async接收器的缓冲问题 #

如果使用Async接收器，默认会有缓冲机制，可能导致日志延迟输出。可修改appsettings.json的Serilog配置，添加刷新间隔或调整缓冲区大小：

"Serilog": {
    "Using": [ "Serilog.Sinks.Console", "Serilog.Sinks.Async" ],
    "MinimumLevel": {
      "Default": "Verbose",
      "Override": {
        "Microsoft": "Warning",
        "Microsoft.AspNetCore": "Warning",
        "System": "Error"
      }
    },
    "WriteTo": [
      {
        "Name": "Async",
        "Args": {
          "bufferSize": 100,
          "flushToDiskInterval": "00:00:01", // 每秒刷新一次缓冲区
          "configure": [
            {
              "Name": "Console",
              "Args": {
                "theme": "Serilog.Sinks.SystemConsole.Themes.AnsiConsoleTheme::Code, Serilog.Sinks.Console",
                "formatter": "Serilog.Formatting.Compact.RenderedCompactJsonFormatter, Serilog.Formatting.Compact"
              }
            }
          ]
        }
      }
    ]
  }

4. 临时排除Async接收器，验证基础功能 #

若上述配置仍无效，可暂时移除Async接收器，直接使用Console接收器测试，确认核心功能正常：

"Serilog": {
    "Using": [ "Serilog.Sinks.Console" ],
    "MinimumLevel": {
      "Default": "Verbose",
      "Override": {
        "Microsoft": "Warning",
        "Microsoft.AspNetCore": "Warning",
        "System": "Error"
      }
    },
    "WriteTo": [
      {
        "Name": "Console",
        "Args": {
          "theme": "Serilog.Sinks.SystemConsole.Themes.AnsiConsoleTheme::Code, Serilog.Sinks.Console",
          "formatter": "Serilog.Formatting.Compact.RenderedCompactJsonFormatter, Serilog.Formatting.Compact"
        }
      }
    ]
  }

5. 验证日志级别是否被覆盖 #

在控制器中尝试输出更高优先级的日志（如Warning），确认是否是级别过滤问题：

public IActionResult Index()
{
    _logger.LogWarning("Home/Index - Warning level");
    _logger.LogInformation("Home/Index - Information level");
    return View();
}

内容的提问来源于stack exchange，提问作者Filipe Nóbrega