.NET 6 Razor Pages中区域（Area）内页面自定义路由映射失效问题

我懂你遇到的麻烦——根目录Pages文件夹下用AddPageRoute配置路由别名顺风顺水，但到了Area里就彻底失效，只能靠完整路径或者视图里硬加@page属性凑合用，对吧？其实问题核心在于路由约定的作用范围，全局的AddPageRoute只针对根Pages文件夹，Area内的页面得用专属的配置方式。

先梳理你的场景 #

• 根Pages下的/Account/login，用options.Conventions.AddPageRoute("/Account/login", "login")能成功把login短路由映射到该页面
• 但位于/Areas/Identity/Pages/Account/Login的页面，用同样的全局配置完全不起作用，只能通过完整路径http://localhost/identity/Account/login访问，或者在视图里加@page "/"临时解决

正确解决方案：使用Area专属路由约定 #

你需要把全局的AddPageRoute替换成AddAreaPageRoute方法，这个方法专门负责Area内页面的路由配置，代码如下：

builder.Services.AddRazorPages()
    .AddRazorPagesOptions(options => {
        // 参数说明：Area名称 → Area内页面相对路径（从Area的Pages目录开始） → 要映射的短路由
        options.Conventions.AddAreaPageRoute("Identity", "/Account/Login", "login");
    })
    .AddRazorRuntimeCompilation();

关键参数解释 #

• 第一个参数"Identity"：对应你项目里的/Areas/Identity文件夹，名称要完全匹配（虽然.NET默认路由不区分大小写，但保持一致能避免不必要的坑）
• 第二个参数"/Account/Login"：是Area内页面的相对路径，从/Areas/Identity/Pages目录开始计算，正好对应你的Login.cshtml文件位置
• 第三个参数"login"：就是你想要的短路由，配置完成后，访问http://localhost/login就能直接打开Area里的登录页面了

为什么原来的方法无效？ #

全局的AddPageRoute只会扫描根目录下的Pages文件夹，不会遍历Areas目录下的页面，所以路由系统根本找不到你指定的/identity/Account/login对应的Area页面。而AddAreaPageRoute会明确指定作用的Area范围，让路由系统精准定位到目标页面。

如果之后需要给Area页面配置更复杂的路由规则（比如路由约束、多个别名），还可以结合AreaPageRouteModelConvention做精细化配置，但这个场景下用AddAreaPageRoute就完全够用了。

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