迁移至.NET Core后无法配置匹配旧.NET项目的MVC路由求助

嘿，我之前迁移旧.NET项目到Core时也踩过类似的路由坑，咱们一步步来排查和解决这个问题：

先搞懂旧.NET与.NET Core路由的核心差异 #

旧版.NET的路由配置集中在RouteConfig.cs里，而.NET Core把路由配置整合到了请求管道（中间件）中，且对中间件顺序有严格要求——这也是很多人踩坑的关键点。

给你Startup.cs的标准配置模板（适配.NET Core 3.x及更早版本） #

首先确保你在ConfigureServices和Configure方法里的配置都到位：

1. 注册MVC服务（ConfigureServices方法） #

必须先注册对应的控制器服务，不然路由根本找不到你的HomeController：

public void ConfigureServices(IServiceCollection services)
{
    // 如果是带视图的MVC项目用这个
    services.AddControllersWithViews();
    // 如果是纯API项目用 services.AddControllers();
}

2. 配置路由中间件（Configure方法） #

注意中间件的顺序！UseRouting必须在UseEndpoints之前，其他中间件也要按顺序放：

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(); // 授权中间件在路由之后、终点之前

    // 配置和旧版RouteConfig一致的默认路由
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllerRoute(
            name: "default",
            pattern: "{controller=Home}/{action=Index}/{id?}");
        // 这里的{controller=Home}表示默认控制器是Home，{action=Index}表示默认Action是Index
    });
}

排查无法命中HomeController的常见原因 #

如果配置完还是不行，按下面的点逐一排查：

• Controller命名规则：你的控制器类必须叫HomeController（后缀Controller不能少），且要继承自Controller或ControllerBase
• Action访问权限：Action方法必须是public修饰的，私有方法路由无法访问
• 路由匹配顺序：如果有自定义路由，要把它放在默认路由前面（路由是按顺序匹配的，先匹配到的会生效）
• 请求URL是否正确：比如默认路由下，访问/会自动映射到Home/Index，访问/Home也会命中Home/Index；如果直接访问/Home/Test，要确保HomeController里有public IActionResult Test()方法
• 中间件顺序错误：比如把UseEndpoints放在UseRouting前面，或者UseStaticFiles位置不对，都会导致路由失效
• 属性路由冲突：如果你的Controller或Action加了[Route]特性，要检查特性里的路径是否和传统路由冲突，或者是否需要调整路由优先级

如果是迁移到.NET 6+（使用Program.cs顶级语句） #

如果你的项目是.NET 6及以上版本，配置逻辑类似但写法更简洁，给你参考：

var builder = WebApplication.CreateBuilder(args);

// 注册服务
builder.Services.AddControllersWithViews();

var app = builder.Build();

// 配置请求管道
if (!app.Environment.IsDevelopment())
{
    app.UseExceptionHandler("/Home/Error");
    app.UseHsts();
}

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

// 配置默认路由
app.MapControllerRoute(
    name: "default",
    pattern: "{controller=Home}/{action=Index}/{id?}");

app.Run();

要是按上面的步骤配置后还是有问题，可以打开开发环境的异常页，查看控制台里的路由匹配日志，里面会告诉你请求到底匹配了哪些路由，为什么没命中HomeController。

内容的提问来源于stack exchange，提问作者Srééjîth Náîr