.NET Core 5设置默认启动路由访问Clients控制器404解决方案

问题根因 #

修改默认约定路由后仍返回404，是ASP.NET Core路由优先级规则导致的：
属性路由优先级远高于传统约定路由，且标记了[Route]特性的Action不会再参与约定路由匹配。
你在ClientsController.Index上标记了[Route("/Clients")]，该Action仅会响应/Clients路径的请求；你配置的根路径到Clients/Index的约定路由规则，会因为Action被属性路由接管而失效，根路径找不到匹配的终结点就会返回404。

规范实现方案 #

根据你需要的行为二选一即可，都是官方推荐的无补丁写法，兼容.NET 5及后续.NET 6+版本：

方案1：根路径直接渲染Clients页面（URL保持为/，无跳转）

如果不需要修改浏览器地址栏，直接让根路径返回Clients列表内容，选这个方案：

• 如果你要保留现有/Clients的属性路由配置，只需要给Index Action追加根路径的路由映射，不需要改Startup里的路由：

[HttpGet]
[Route("/")] // 新增：让根路径匹配当前Action
[Route("/Clients")]
public async Task<IActionResult> Index(int? pageNumber)
{
    // 原有业务逻辑不需要修改
}

• 如果你不需要单独给/Clients加属性路由，可以直接删掉Index方法上的[HttpGet]、[Route("/Clients")]两个特性，你之前修改的默认约定路由就可以直接生效：

// Startup.cs 路由配置保持你修改后的内容即可
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Clients}/{action=Index}/{id?}");
});

方案2：访问根路径自动跳转到/Clients（地址栏变为/Clients，和你描述的“等效于访问/Clients路径”行为完全一致）

如果需要和传统ASP.NET设置启动页一样，访问根路径时跳转至/Clients地址，直接在路由配置里加重定向规则即可，不需要改Controller代码：

app.UseEndpoints(endpoints =>
{
    // 新增根路径重定向规则
    endpoints.MapGet("/", context =>
    {
        // permanent: true 返回301永久重定向，适合生产环境固定入口；测试阶段用false返回302临时重定向即可
        context.Response.Redirect("/Clients", permanent: false);
        return Task.CompletedTask;
    });

    // 原有默认路由配置可以保留，不需要强制修改默认控制器为Clients
    endpoints.MapControllerRoute(
        name: "default",
        pattern: "{controller=Home}/{action=Index}/{id?}");
});

补充说明 #

你的ClientsController标记了[Authorize]权限特性，以上两种方案都会自动继承权限校验逻辑：未登录用户访问根路径时，会和直接访问/Clients一样自动跳转到登录页，不需要额外处理权限逻辑。

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