ASP.NET Core 6中Area路由Url.Action生成链接异常求助

问题描述 #

我有一个.NET MVC Core 6应用程序，包含名为Dashboard的Area。在Startup的Configure方法中配置了路由：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Home/Error");
        // The default HSTS value is 30 days. You may want to change this for production scenarios.
        app.UseHsts();
    }
    app.UseHttpsRedirection();
    app.UseRouting();

    app.UseAuthentication();
    app.UseAuthorization();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapDefaultControllerRoute();
        endpoints.MapAreaControllerRoute(
            name: "Dashboard",
            areaName: "Dashboard",
            pattern: "D/{controller=Home}/{action=Index}/{id?}"
        );
        // other areas configurations goes here 
        endpoints.MapControllerRoute(
            name: "areas",
            pattern: "{area:exists}/{controller}/{action}/{id?}"
          );
    });
}

当前访问http://localhost/d/dashboard能正确指向Dashboard区域，但使用Url.Action生成链接时不符合预期：

• 执行Url.Action("Index", "Dashboard", new { area = "d" })，生成链接为https://localhost/Dashboard?area=d，而非预期的http://localhost/d/dashboard
• 改为Url.Action("Index", "Dashboard", new { area = "Dashboard" })，生成链接为https://localhost/Dashboard?area=Dashboard，仍不符合预期

问题原因 #

路由匹配和链接生成时，MapAreaControllerRoute定义的规则需要明确指定路由名称才能被正确选中，默认情况下Url.Action会优先匹配更通用的路由（比如MapDefaultControllerRoute或areas路由），而非自定义的Dashboard区域路由。

解决方案 #

方案1：指定路由名称生成链接 #

使用Url.RouteUrl方法，明确指定自定义的Dashboard路由名称，传入对应参数即可生成预期链接：

Url.RouteUrl("Dashboard", new { controller = "Dashboard", action = "Index" })

该方法会直接匹配你定义的D/{controller=Home}/{action=Index}/{id?}路由规则，生成/d/dashboard链接。

方案2：调整路由注册顺序（可选） #

如果希望Url.Action能自动匹配到自定义区域路由，可以调整路由注册顺序，把自定义的MapAreaControllerRoute放在MapDefaultControllerRoute之前：

app.UseEndpoints(endpoints =>
{
    // 先注册自定义区域路由
    endpoints.MapAreaControllerRoute(
        name: "Dashboard",
        areaName: "Dashboard",
        pattern: "D/{controller=Home}/{action=Index}/{id?}"
    );
    // 再注册默认路由和通用区域路由
    endpoints.MapDefaultControllerRoute();
    endpoints.MapControllerRoute(
        name: "areas",
        pattern: "{area:exists}/{controller}/{action}/{id?}"
      );
});

调整顺序后，路由系统会优先匹配先注册的更具体的路由规则，此时使用Url.Action("Index", "Dashboard", new { area = "Dashboard" })就能正确生成/d/dashboard链接。

额外说明 #

• 路由名称是精准匹配的关键：自定义MapAreaControllerRoute的name参数（此处为"Dashboard"）是链接生成时唯一能定位到该路由的标识。
• area参数需传入区域真实名称（"Dashboard"），URL中的前缀"d"是路由规则pattern中定义的映射，路由系统会自动根据区域名称和规则生成对应URL前缀。

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