.NET 6中UsePathBase生效但MapControllers路由不识别路径基准问题

在.NET 2.1里，UsePathBase配合UseMvc能正常提取路径前缀，让路由只处理剩余部分；但到了.NET 6的最小API模型中，直接用UsePathBase+MapControllers会出现路由匹配失效的问题，核心原因是中间件顺序和路由系统的隐式行为发生了变化。

问题根源 #

.NET 6中MapControllers()会隐式注册路由和端点中间件，但如果UsePathBase的位置不对，路由系统无法正确读取修改后的PathBase值，导致无法匹配/app1/home/index这类带前缀的请求。

正确实现方式 #

你需要显式控制中间件顺序，确保UsePathBase在路由中间件之前执行，同时用UseRouting()和UseEndpoints()包裹端点注册逻辑：

// 1. 设置路径基，必须放在路由中间件之前
app.UsePathBase("/app1");

// 2. 显式启用路由中间件
app.UseRouting();

// 3. 在端点中间件中注册控制器路由
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
});

可选替代方案（直接指定路由前缀） #

如果不想依赖UsePathBase，也可以直接给控制器统一添加路由前缀，或者在MapControllers时配置全局前缀：

// 方案1：给控制器添加路由前缀
[Route("app1/[controller]/[action]")]
public class HomeController : Controller
{
    public IActionResult Index()
    {
        return Ok();
    }
}

// 方案2：在MapControllers时统一配置前缀
app.MapControllers().WithMetadata(new RouteAttribute("app1/{controller=Home}/{action=Index}"));

验证要点 #

• 确保UsePathBase在UseRouting之前执行，这样路由系统才能获取正确的PathBase值
• 可以通过中间件输出关键参数确认：

  app.Use((context, next) =>
  {
      Console.WriteLine($"PathBase: {context.Request.PathBase}, Path: {context.Request.Path}");
      // 正常情况下，请求/app1/home/index会输出：PathBase: /app1, Path: /home/index
      return next.Invoke();
  });
  

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