ASP.NET Core 6适配5风格Program.cs报错：原因分析与解决方案

问题原因 #

ASP.NET Core 6 引入了顶级语句（Top-level statements）和最小API模式作为默认项目模板，移除了对传统Program.Main方法+Startup类自动映射的默认支持。直接复用ASP.NET Core 5的Program.cs代码时，会因为宿主构建逻辑（HostBuilder vs WebApplicationBuilder）不匹配，导致启动时无法正确加载Startup类的配置，从而抛出异常。

解决方案 #

提供两种可行方案，按需选择：

方案1：修改Program.cs适配Core6宿主构建逻辑 #

保留现有的Startup.cs，调整Program.cs代码，手动调用Startup类的配置方法：

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;

// 创建Core6的WebApplicationBuilder实例
var builder = WebApplication.CreateBuilder(args);

// 初始化Startup并配置服务
var startup = new Startup(builder.Configuration);
startup.ConfigureServices(builder.Services);

// 构建应用实例
var app = builder.Build();

// 应用中间件配置
startup.Configure(app, app.Environment);

// 启动应用
app.Run();

你的Startup.cs可以保持ASP.NET Core 5的风格，注意替换过时的IHostingEnvironment为IWebHostEnvironment：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;

public class Startup
{
    public IConfiguration Configuration { get; }

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

    public void ConfigureServices(IServiceCollection services)
    {
        // 示例：添加MVC服务
        services.AddControllersWithViews();
        // 你的其他服务配置逻辑
    }

    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        else
        {
            app.UseExceptionHandler("/Home/Error");
            app.UseHsts();
        }

        app.UseHttpsRedirection();
        app.UseStaticFiles();
        app.UseRouting();
        app.UseAuthorization();

        app.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
    }
}

方案2：修改项目文件启用兼容模式 #

通过修改项目的.csproj文件，强制禁用顶级语句和最小API模板，让项目兼容ASP.NET Core 5的Program+Startup结构：

打开你的项目文件，在<PropertyGroup>节点中添加以下配置：

<UseDotNetStartupTemplates>false</UseDotNetStartupTemplates>
<EnableTopLevelStatements>false</EnableTopLevelStatements>

之后就可以直接使用ASP.NET Core 5风格的Program.cs：

using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.Hosting;

namespace YourProjectNamespace
{
    public 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类或无法解析服务的异常，检查：

• Startup类是否为public访问修饰符
• ConfigureServices和Configure方法的参数是否与宿主提供的类型匹配（Core6中优先使用IWebHostEnvironment而非过时的IHostingEnvironment）
• Program.cs中是否正确引用了Startup类的命名空间

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