ASP.NET Core 7中Razor页面与控制器端点冲突的优先级及覆盖方案

问题场景 #

在同时启用Razor页面和MVC的ASP.NET Core 7项目中，出现以下情况：

• Razor类库（RCL）中包含Pages/Account/Login.cshtml及代码后置文件，作为默认登录页面
• 项目中新增AccountController，其中的Login Action试图覆盖该登录端点
• 无论app.MapRazorPages()在Program.cs中放在控制器路由注册的前后，始终是Razor页面优先响应/Account/Login请求；只有注释掉app.MapRazorPages()时，MVC控制器才会生效

相关代码如下：

Program.cs #

builder.Services.AddMvc();
builder.Services.AddRazorPages().AddRazorRuntimeCompilation();

// ...

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

// 即使放在控制器路由之后，Razor页面依然优先
app.MapRazorPages();

AccountController.cs #

using Microsoft.AspNetCore.Mvc;

namespace RazorClassLibrary.Controllers
{
    public class AccountController : Controller
    {
        [HttpGet]
        public IActionResult Login()
        {
            return Content("This is an override from the RCL.");
        }
    }
}

原因分析 #

ASP.NET Core的路由匹配优先级由路由模板的特异性决定：

• Razor页面默认基于文件路径生成完全匹配的路由模板（比如/Account/Login），属于最高特异性的路由
• MVC控制器的Login Action默认使用通用路由模板{controller}/{action}，特异性远低于完全匹配的路由
  因此，即使调整MapRazorPages()的注册顺序，Razor页面的路由也会优先被匹配。

解决方案 #

要让控制器Action覆盖Razor页面，有两种简单可行的方式：

方式一：给控制器Action添加完全匹配的路由属性 #

给Login Action添加[Route]属性，指定与Razor页面完全一致的路由模板。此时两者路由特异性相同，先注册的端点会优先匹配（由于MapControllerRoute在MapRazorPages之前注册，控制器端点会被优先命中）。

修改后的AccountController.cs：

using Microsoft.AspNetCore.Mvc;

namespace RazorClassLibrary.Controllers
{
    public class AccountController : Controller
    {
        [HttpGet]
        [Route("/Account/Login")] // 添加完全匹配的路由
        public IActionResult Login()
        {
            return Content("This is an override from the RCL.");
        }
    }
}

方式二：修改Razor页面的路由模板 #

在RCL的Login.cshtml顶部修改@page指令，指定新的路由路径，让原/Account/Login路径不再匹配该Razor页面，从而让MVC默认路由接管请求。

修改后的Login.cshtml：

@page "/Account/LoginPage" // 更改Razor页面的路由
@model RazorClassLibrary.Pages.Account.LoginModel

<!-- 原页面内容 -->

其他可选方案 #

• 如果不需要保留RCL中的Login Razor页面，可以直接从RCL中移除该文件，或在项目中通过配置排除它
• 自定义路由匹配逻辑，通过AddRazorPagesOptions调整Razor页面的路由优先级，但这种方式复杂度较高，不推荐用于简单场景

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