Html.ActionLink未识别当前Area生成错误链接问题排查

背景 #

从.NET 4.7.2的ASP.NET MVC 5迁移至.NET 7.0的ASP.NET Core时，遇到Area功能异常：Area内视图调用Html.ActionLink生成的链接始终指向默认区域，而非当前Area（MVC5中可自动识别当前Area）。

代码示例 #

视图代码（Areas/Manager/Views/Home/Index.cshtml） #

当前页面路径为/Manager，代码如下：

<p>@Html.ActionLink("Display everything", "Index", new { All = 1, })</p>

预期结果：生成/Manager?All=1、/Manager/Home?All=1或/Manager/Home/Index?All=1
实际结果：生成默认区域链接/?All=1

Area控制器代码 #

业务控制器（Areas/Manager/Controllers/HomeController.cs）

public class HomeController : Controller
{
    public ActionResult Index(string All = null)
    {
         // ...业务逻辑
    }
}

Area父控制器（Areas/Manager/Controllers/Controller.cs）

[Area("Manager")]
public class Controller : BaseBackofficeController
{
    // ...

    public override Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next) { /* 无关代码 */ }
}

全局父控制器（Shared/BaseBackofficeController.cs）

public abstract class BaseBackofficeController : Microsoft.AspNetCore.Mvc.Controller
{
    // ...无关代码
}

路由配置（Startup.cs） #

app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(name: "default", pattern: "{controller=Home}/{action=Index}/{id?}");
    endpoints.MapAreaControllerRoute("Manager", "Manager", "Manager/{controller=Home}/{action=Index}/{id?}");
    // 其他无关路由
});

已尝试的无效方案 #

• 将[Area("Manager")]直接添加到业务控制器而非父控制器，问题未解决
• 使用@Html.ActionLink("Display everything", "Index", "Home", new { All = 1, })，仍生成/?All=1
• 使用@Html.ActionLink("Display everything", "Index", "Home", new { All = 1, area = "Manager", })，生成/?All=1&area=Manager，UrlHelper未识别Area参数

原因分析 #

1. 路由注册顺序错误：ASP.NET Core路由匹配按注册顺序执行，默认路由先于Area路由注册时，UrlHelper会优先匹配默认路由，忽略Area上下文
2. 控制器命名冲突：Area内自定义的Controller类与框架的Microsoft.AspNetCore.Mvc.Controller重名，导致框架无法正确识别控制器的Area属性上下文

修复方案 #

1. 调整路由注册顺序 #

将Area路由移至默认路由之前，确保Area相关请求优先匹配Area路由：

app.UseEndpoints(endpoints =>
{
    endpoints.MapAreaControllerRoute("Manager", "Manager", "Manager/{controller=Home}/{action=Index}/{id?}");
    endpoints.MapControllerRoute(name: "default", pattern: "{controller=Home}/{action=Index}/{id?}");
    // 其他路由
});

2. 解决控制器命名冲突 #

重命名Area内的自定义父控制器，避免与框架基类重名，例如改为ManagerBaseController：

[Area("Manager")]
public class ManagerBaseController : BaseBackofficeController
{
    // ...原有逻辑

    public override Task OnActionExecutionAsync(ActionExecutingContext context, ActionExecutionDelegate next) { /* 无关代码 */ }
}

修改业务控制器的继承关系：

public class HomeController : ManagerBaseController
{
    public ActionResult Index(string All = null)
    {
         // ...业务逻辑
    }
}

3. 验证性方案（显式指定Area） #

若需快速验证，可使用ActionLink的完整重载，明确指定Area参数（避免参数重载混淆）：

@Html.ActionLink("Display everything", "Index", "Home", new { area = "Manager", All = 1 }, null)

注：最后一个null为HTML属性参数，用于确保调用正确的重载方法。

验证效果 #

调整完成后，Area内的Html.ActionLink将自动识别当前Area上下文，生成符合预期的链接（如/Manager?All=1）。

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