.NET 8中静态文件与通配符路由模板冲突问题求助

核心变更说明 #

在.NET 8中，端点路由（Endpoint Routing）的匹配逻辑做了关键调整：所有注册的端点（包括带通配符的最小API）会被优先评估，哪怕静态文件中间件在它们之前注册。

而在.NET 7及更早版本中，静态文件中间件是在端点路由执行前运行的——只要请求匹配到静态文件，中间件就会直接处理请求并终止管道，根本不会进入端点路由的匹配阶段。这就是你旧写法在老版本可行，但.NET 8里静态文件被忽略的原因。

解决方案 #

方法1：使用MapFallback替代通配符MapGet #

MapFallback是.NET专门为兜底场景设计的API，它只会在没有任何其他端点（包括静态文件的隐含匹配）命中时才会触发，完全不会干扰静态文件的处理：

app.MapFallback(() =>
{
    return Results.Content($"<h1>Hello World</h1>", "text/html");
});

方法2：还原旧版本的中间件执行顺序 #

如果你一定要保留原有的MapGet写法，可以手动调整管道顺序，让静态文件中间件在端点路由之前处理请求：

// 先处理静态文件
app.UseStaticFiles();
// 手动启用端点路由
app.UseRouting();
// 在端点路由中注册你的通配符API
app.UseEndpoints(endpoints =>
{
    endpoints.MapGet("{*UrlParts}", (string? UrlParts) =>
    {
        return Results.Content($"<h1>Hello World</h1>", "text/html");
    }).WithOrder(10000);
});

推荐使用第一种方法，它更符合.NET 8的设计意图，代码也更简洁。

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