.NET 6切换托管模型时Startup类注入ILogger异常原因及解决

一、为什么.NET Core 2.1的CreateWebHost能正常注入ILogger #

在.NET Core 2.1的WebHostBuilder流程中，日志系统的初始化优先于Startup类的实例化：

• WebHostBuilder会先完成日志服务的配置（包括默认日志提供程序或自定义的Serilog），并将日志服务注册到DI容器中。
• 当实例化Startup类时，DI容器已经包含了完整的日志服务实例，因此构造函数中的ILogger<Startup>可以被正常解析。
• 2.1版本中，Startup类的构造注入是由WebHost直接处理的，日志服务的就绪时机完全覆盖了Startup的初始化流程。

二、.NET Core 3.1/6.0中注入失败的原因 #

从.NET Core 3.1开始，通用主机（HostBuilder）取代了原有的WebHost作为默认主机模型，6.0的最小托管模型也是基于通用主机演进的：

• 通用主机的初始化流程中，Startup类的实例化时机早于日志服务的完全注册。默认情况下，DI容器在Startup构造阶段还未完成日志服务的配置，因此无法解析ILogger<Startup>。
• 即使你配置了Serilog，若未提前将其绑定到主机的日志系统，DI容器在Startup初始化时仍无法找到对应的日志实例。

三、解决方法：提前配置Serilog到主机日志系统 #

核心思路是在主机构建完成前，将自定义配置的Serilog实例提前注册到主机的日志管道中，确保DI容器在Startup实例化前就能提供ILogger实例。

1. .NET Core 3.1（CreateHost方式） #

using Serilog;

// 提前配置并创建Serilog实例
var loggerConfig = new LoggerConfiguration()
    .ReadFrom.Configuration(new ConfigurationBuilder()
        .AddJsonFile("appsettings.json")
        .AddCommandLine(args)
        .Build())
    // 自定义日志配置（如输出模板、Sink等）
    .CreateLogger();

var host = Host.CreateDefaultBuilder(args)
    // 将Serilog设置为主机的日志提供程序
    .UseSerilog(loggerConfig)
    .ConfigureWebHostDefaults(webBuilder =>
    {
        webBuilder.UseStartup<Startup>();
    })
    .Build();

host.Run();

2. .NET 6最小托管模型（保留独立Startup类） #

using Serilog;

// 提前配置Serilog
var logger = new LoggerConfiguration()
    .ReadFrom.Configuration(new ConfigurationBuilder()
        .AddJsonFile("appsettings.json")
        .Build())
    .CreateLogger();

var builder = WebApplication.CreateBuilder(args);

// 将Serilog注入到主机
builder.Host.UseSerilog(logger);

// 保留独立Startup类的方式：直接使用UseStartup
builder.WebHost.UseStartup<Startup>();

var app = builder.Build();
app.Run();

额外说明 #

• 若不想提前创建Serilog实例，也可以通过UseSerilog()的重载方法，在主机配置阶段动态配置Serilog，同样能保证日志服务在Startup初始化前就绪：

  builder.Host.UseSerilog((context, config) =>
  {
      config.ReadFrom.Configuration(context.Configuration);
  });
  

• 若必须在Startup构造函数中依赖日志做初始化逻辑，提前注册日志服务是唯一可靠的方案。

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