.NET 6升级至.NET 8时Startup类多构造函数运行时错误

这个错误的核心原因是：.NET 6+的ASP.NET Core依赖注入容器对Startup类的构造函数解析规则更严格——当存在多个构造函数都能被DI容器满足参数需求时，容器无法自动确定使用哪一个，因此抛出该运行时异常。

以下是具体解决方案：

方案1：保留单个构造函数 #

检查你的Startup.cs，删除多余的构造函数，只保留一个需要的构造函数（通常是接收IConfiguration或IWebHostEnvironment的构造函数）。

示例修改后的Startup类：

public class Startup
{
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    public IConfiguration Configuration { get; }

    public void ConfigureServices(IServiceCollection services)
    {
        // 你的服务配置代码
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        // 你的中间件配置代码
    }
}

方案2：显式指定要使用的构造函数 #

如果确实需要保留多个构造函数，可以使用[ActivatorUtilitiesConstructor]特性标记DI容器应该优先使用的构造函数，明确告诉容器选择逻辑。

示例：

public class Startup
{
    [ActivatorUtilitiesConstructor]
    public Startup(IConfiguration configuration)
    {
        Configuration = configuration;
    }

    // 保留其他构造函数，但DI会优先使用标记了特性的那个
    public Startup(IWebHostEnvironment env)
    {
        var builder = new ConfigurationBuilder()
            .SetBasePath(env.ContentRootPath)
            .AddJsonFile("appsettings.json", optional: true, reloadOnChange: true)
            .AddEnvironmentVariables();
        Configuration = builder.Build();
    }

    public IConfiguration Configuration { get; }

    // 其他配置方法...
}

额外优化（可选） #

如果你的项目仍在使用传统的Program+Startup结构，可以迁移到.NET 8推荐的顶级语句风格，直接移除Startup类，将配置逻辑整合到Program.cs中，从根源避免构造函数冲突问题：

var builder = WebApplication.CreateBuilder(args);

// 服务配置
builder.Services.AddControllers();
// 其他服务注册代码...

var app = builder.Build();

// 中间件配置
if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}

app.UseHttpsRedirection();
app.UseAuthorization();
app.MapControllers();

app.Run();

内容的提问来源于stack exchange，提问作者Aarti Karnik - OIT