ASP.NET Core 5 MVC 区域路由全局配置无法自动移除Index操作名问题

解决方法 #

根因说明 #

你当前配置的全局区域路由中action是路径的显式分段，当你调用@Url.Action时显式指定了action=Index，路由系统默认会将显式传入的参数值拼入路径，哪怕该值是路由默认值，因此会出现带/Index/的路径。

配置调整 #

在UseEndpoints配置中，新增一条优先级更高的、专门适配Index动作的路由规则，放在原有区域路由之前即可：

app.UseEndpoints(endpoints =>
{
    // 新增：适配所有区域下Index动作的无action段路由，优先级最高
    endpoints.MapControllerRoute(
        name: "areaIndexOmitAction",
        pattern: "Org/{orgName}/{area:exists}/{controller=Home}/{id?}",
        defaults: new { action = "Index" },
        constraints: new { action = "Index" }
    );

    // 原有普通区域路由，放在后面
    endpoints.MapControllerRoute(
      name: "areaRoute",
      pattern: "Org/{orgName}/{area:exists}/{controller=Home}/{action=Index}/{id?}"
    );

    // 其他原有路由配置保持不变
});

注意事项 #

• 移除之前加在Index动作上的硬编码[Route]特性，属性路由优先级高于约定路由，会导致全局配置失效
• 如果orgName不是当前请求上下文自带的环境路由值，生成URL时需要显式传入该参数：

  @Url.Action("Index", "TaskRunLog", new { orgName = "Paradox", Area = "Importer", Id = item.Id })
  

• 确保没有其他优先级更高的路由规则（比如全局属性路由、其他前置自定义路由）覆盖上述配置

配置完成后所有区域下的Index动作都会自动匹配该规则，生成URL时自动省略Index段，无需每个动作单独加特性。

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