.NET 7 API如何配置不覆盖静态文件的通配路由？

核心问题分析 #

你遇到的情况是属性路由的通配模板/{**catchAll}会优先匹配请求，甚至拦截了本应由静态文件中间件处理的请求。本质原因是端点路由的匹配逻辑中，未明确设置通配路由的最低优先级，或是没有利用框架专门的兜底路由机制。

解决方法一：使用MapFallbackToController（推荐） #

框架提供的MapFallbackToController是专门为“兜底路由”设计的API，它会确保只有当静态文件、其他控制器路由都不匹配时，才触发对应的处理方法，完美满足静态文件优先的需求。

1. 修改Program.cs的中间件注册顺序：

app
   .UseDefaultFiles()
   .UseStaticFiles()
   .MapControllers()
   // 第一个参数是控制器方法名，第二个是控制器类名（去掉Controller后缀）
   .MapFallbackToController("CatchNonExistingRoute", "Error");

app.Run();

2. 调整控制器方法，无需再添加通配路由属性：

public class ErrorController : ControllerBase
{
    public IActionResult CatchNonExistingRoute()
    {
        // 自定义实现逻辑，例如返回404响应
        return NotFound("请求的资源不存在");
    }
}

解决方法二：给属性路由设置最低优先级 #

如果必须保留属性路由的写法，可以通过Order属性将通配路由的优先级设为最低，让它在所有其他路由之后才被匹配：

// 设置Order为int.MaxValue，确保该路由是最后被匹配的选项
[Route("/{**catchAll}", Order = int.MaxValue)]
public IActionResult CatchNonExistingRoute()
{
    // 你的实现逻辑
    return NotFound();
}

关键注意事项 #

确保UseStaticFiles()始终在MapControllers()之前调用，这样静态文件中间件会先处理存在的文件请求，直接返回响应而不会进入端点路由阶段。

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