.NET 6 Web API恢复Startup类时ConfigureServices参数错误问询

问题背景 #

在.NET 6 Web API项目中恢复Startup类、迁移服务注册逻辑后，出现错误：
The ConfigureServices method must either be parameterless or take only one parameter of type IServiceCollection

错误源于初始Startup类的ConfigureServices方法包含两个参数，不符合框架对该方法的参数要求。尝试通过全局定义_builder调整但未解决问题，以下是正确的修正方案。

原错误代码 #

修改后的Program.cs #

public static class Program
{
    public static void Main(string[] args)
    {
        BuildWebHost(args).Run();
    }

    public static IWebHost BuildWebHost(string[] args)
    {
        return WebHost.CreateDefaultBuilder(args)
            .UseStartup<Startup>()
            .Build();
    }
}

初始Startup类 #

public class Startup
{
    public WebApplication InitializeApp()
    {
        var builder = WebApplication.CreateBuilder();
        IServiceCollection servicesservices = builder.Services;
        ConfigureServices(servicesservices, builder);
        var app = builder.Build();
        Configure(app);
        return app;
    }

    public void ConfigureServices(IServiceCollection services, WebApplicationBuilder builder)
    {
        ConfigurationManager configuration = builder.Configuration;
        services.AddApplicationLayer();
        services.AddPersistanceLayer(builder.Configuration);
        services.AddControllers();
        services.AddEndpointsApiExplorer();
        services.AddSwaggerGen(c =>
        {
            c.SwaggerDoc("v1", new OpenApiInfo { Title = "VehicleReservation", Version = "v1" });
        });
    }

    public void Configure(WebApplication app)
    {
        // Configure the HTTP request pipeline.
        if (app.Environment.IsDevelopment())
        {
            app.UseSwagger();
            app.UseSwaggerUI();
        }

        app.UseHttpsRedirection();
        app.UseErrorHandlingMiddleware();
        app.UseAuthorization();

        app.MapControllers();

        SeedDatabase(app);
    }

    private void SeedDatabase(WebApplication app)
    {
        using (var scope = app.Services.CreateScope())
        {
            var services = scope.ServiceProvider;
            var vehicleReservationContext = services.GetRequiredService<VehicleReservationContext>();
            VehicleReservationContextSeed.SeedAsync(vehicleReservationContext);
        }
    }
}

正确修正方案 #

方案说明 #

1. 移除Startup中手动创建WebApplicationBuilder的逻辑，改为通过构造函数注入IConfiguration获取配置。
2. 确保ConfigureServices方法仅接受IServiceCollection参数，符合框架要求。
3. 调整Program.cs为标准的WebHost构建方式，通过UseStartup<Startup>自动调用Startup的配置方法。

修正后的Program.cs #

public static class Program
{
    public static void Main(string[] args)
    {
        CreateHostBuilder(args).Build().Run();
    }

    public static IHostBuilder CreateHostBuilder(string[] args) =>
        Host.CreateDefaultBuilder(args)
            .ConfigureWebHostDefaults(webBuilder =>
            {
                webBuilder.UseStartup<Startup>();
            });
}

修正后的Startup类 #

public class Startup
{
    private readonly IConfiguration _configuration;

    // 通过构造函数注入IConfiguration，替代直接依赖WebApplicationBuilder
    public Startup(IConfiguration configuration)
    {
        _configuration = configuration;
    }

    // 仅保留IServiceCollection参数，符合框架要求
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddApplicationLayer();
        services.AddPersistanceLayer(_configuration);
        services.AddControllers();
        services.AddEndpointsApiExplorer();
        services.AddSwaggerGen(c =>
        {
            c.SwaggerDoc("v1", new OpenApiInfo { Title = "VehicleReservation", Version = "v1" });
        });
    }

    public void Configure(WebApplication app)
    {
        if (app.Environment.IsDevelopment())
        {
            app.UseSwagger();
            app.UseSwaggerUI();
        }

        app.UseHttpsRedirection();
        app.UseErrorHandlingMiddleware();
        app.UseAuthorization();

        app.MapControllers();

        SeedDatabase(app);
    }

    private void SeedDatabase(WebApplication app)
    {
        using (var scope = app.Services.CreateScope())
        {
            var services = scope.ServiceProvider;
            var vehicleReservationContext = services.GetRequiredService<VehicleReservationContext>();
            // 同步等待种子数据完成，避免异步方法在启动时未执行完毕
            VehicleReservationContextSeed.SeedAsync(vehicleReservationContext).Wait();
        }
    }
}

错误原因分析 #

• 参数不符合要求：框架规定ConfigureServices方法只能无参数或仅接受IServiceCollection类型的单个参数，原代码传入两个参数触发错误。
• 重复构建冲突：原Startup类中手动创建WebApplicationBuilder，与Program.cs中WebHost.CreateDefaultBuilder的构建逻辑重复，导致依赖注入混乱。
• 错误的依赖注入：尝试注入WebApplicationBuilder到Startup构造函数是无效的，框架在使用UseStartup<T>时不会自动注入该类型，应改用标准的IConfiguration或IWebHostEnvironment。

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