.NET 8迁移中Startup无法解析ILoggerFactory依赖问题排查

API 探路者

2026-6-22

问题原因与解决方案

这个错误的核心原因是从WebHost.CreateDefaultBuilder切换到Host.CreateDefaultBuilder后，没有正确配置Web主机相关服务，或者Startup类的构造函数注入时机/方式不符合通用主机的运行逻辑。

具体修复步骤

1. 确保通用主机正确配置Web主机功能

Host.CreateDefaultBuilder是通用主机构建器，默认不会自动启用Web应用所需的完整服务（包括日志工厂的正确注册），必须显式调用ConfigureWebHostDefaults来配置Web相关逻辑：

var builder = Host.CreateDefaultBuilder(args)
    .ConfigureWebHostDefaults(webBuilder =>
    {
        webBuilder.UseStartup<Startup>();
        // 其他Web配置（如UseUrls、UseStaticFiles等）可放在这里
    });

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

2. 调整`Startup`类的注入方式（可选）

如果已经配置了ConfigureWebHostDefaults但仍报错，检查Startup的构造函数：避免直接注入ILoggerFactory，改为注入ILogger<Startup>，或者在ConfigureServices方法中通过服务容器获取日志服务：

// 推荐的构造函数注入方式
public class Startup
{
    private readonly ILogger<Startup> _logger;

    public Startup(IConfiguration configuration, ILogger<Startup> logger)
    {
        Configuration = configuration;
        _logger = logger;
    }

    public IConfiguration Configuration { get; }

    // ... 其他方法
}

或者在ConfigureServices中直接获取日志工厂：

public void ConfigureServices(IServiceCollection services)
{
    var loggerFactory = services.BuildServiceProvider().GetRequiredService<ILoggerFactory>();
    // 使用loggerFactory
}