从Net Core 3.1升级至Net Core 5后Razor Pages单层文件夹路由失效咨询

核心成因 #

该问题不属于.NET Core 5 Razor Pages路由的核心逻辑故障，属于升级后常见的路径匹配冲突或配置残留问题，结合你描述的「多层嵌套路由正常、单层路由失效」的特征，常见成因分为三类：

• 路由优先级冲突
  .NET Core 5对端点路由的模板权重计算规则相对3.1有微调，原本被Razor Pages优先匹配的单层路径，会被其他符合规则的端点抢占，典型场景包括：
  • 控制器标注了参数化特性路由：比如存在Folder1Controller，类上写有[Route("Folder1/[action]")]这类模板，会匹配所有/Folder1/开头的单层路径；多层路径因为多了一段路径参数，无法匹配该模板，所以不受影响
  • Pages根目录下存在带通配符路由的Razor页面：比如Pages/Folder1.cshtml的@page指令写了@page "/Folder1/{**slug}"，会拦截所有/Folder1下的路径请求，未对应处理时会直接返回404
  • 静态文件中间件拦截：wwwroot下存在无后缀的Folder1/Site类静态资源，且UseStaticFiles配置在UseRouting之前，请求会被直接返回静态资源而非进入Razor Pages路由匹配
• 页面@page指令被意外修改
  单层路由对应的cshtml文件（比如Pages/Folder1/Site.cshtml）的@page指令被改成了非默认值，比如写了@page "/Folder1"，导致实际生成的路由是/Folder1而非预期的/Folder1/Site，访问自然失效；多层页面的@page指令未被改动，所以路由正常
• 旧编译缓存残留
  升级时未清理旧版本的编译产物，3.1环境下的Razor生成缓存残留在bin/obj目录中，导致.NET 5无法正确生成单层路由的端点

修复步骤 #

• 第一步：清理编译缓存
  手动删除项目根目录下的bin、obj文件夹，重新执行NuGet还原、项目编译，排除缓存类问题
• 第二步：定位冲突路由
  在Startup.cs的Configure方法末尾临时添加如下代码，输出所有已注册的端点路由：

  app.Run(async (context) =>
  {
      var endpoints = context.RequestServices.GetRequiredService<EndpointDataSource>().Endpoints;
      await context.Response.WriteAsync(string.Join("<br>", endpoints.Select(e => $"{e.DisplayName} | 模板: {(e as RouteEndpoint)?.RoutePattern.RawText}")));
  });
  

  运行项目后访问任意路径，即可看到所有注册的路由，找到能匹配/Folder1/Site的冲突项：
  • 若为控制器路由冲突：移除控制器上多余的路由特性，或者给对应的Razor页面添加显式的@page "/Folder1/Site"指令，提升该路由的匹配优先级
  • 若为通配符Razor页面冲突：修改错误的@page指令，删除多余的通配符参数
  • 若为静态文件冲突：将UseStaticFiles的调用顺序调整到UseRouting之后，或者删除wwwroot下的同名冗余静态资源
• 第三步：检查单层页面的@page指令
  打开所有异常单层路径对应的cshtml文件，确认@page指令没有被修改为非默认值；如果需要自定义路由，确保指令中的路径和预期的访问路径完全一致

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