ASP.NET Core中app.Run()中间件为何覆盖特定路由映射？

问题描述 #

使用app.Map("/hello")创建了处理特定路由的响应逻辑，但添加app.Run()终端中间件后，即使请求/hello也返回Bye；移除该app.Run()后，/hello可正常响应Hello。相关代码如下：

using Microsoft.Extensions.Primitives;
using System.Web;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Map("/hello", async (HttpContext context) => {
    context.Response.ContentType = "text/html";
    await context.Response.WriteAsync("Hello");
});

app.Run(async (HttpContext context) => {
    context.Response.ContentType = "text/html";
    await context.Response.WriteAsync("Bye");
});

app.Run();

原因分析 #

1. 终端中间件的特性：app.Run()添加的是终端中间件，一旦请求到达该中间件，会直接生成响应并终止整个请求管道，不会继续传递给后续逻辑。
2. 路由匹配与中间件顺序冲突：app.Map()是向端点路由系统注册匹配特定路径的终结点，正常情况下，请求进入管道时会先由端点路由中间件匹配已注册的终结点（如/hello）：
   • 匹配成功则执行对应响应逻辑，管道直接结束，不会走到后续的app.Run()。
   • 匹配失败才会触发app.Run()返回Bye。
3. 你遇到的问题本质是错误用app.Run()处理未匹配路由，导致部分场景下路由匹配逻辑被干扰，终端中间件直接接管了所有请求。

解决方法 #

方法1：使用MapFallback处理未匹配路由（推荐） #

MapFallback专门用于处理所有未匹配到已注册路由的请求，不会干扰现有路由的匹配逻辑：

using Microsoft.Extensions.Primitives;
using System.Web;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Map("/hello", async (HttpContext context) => {
    context.Response.ContentType = "text/html";
    await context.Response.WriteAsync("Hello");
});

// 仅处理未匹配到任何路由的请求
app.MapFallback(async (HttpContext context) => {
    context.Response.ContentType = "text/html";
    await context.Response.WriteAsync("Bye");
});

app.Run();

方法2：自定义中间件检查路由 #

如果需要用中间件方式处理默认响应，可通过Use()添加非终端中间件，手动检查路由后再决定是否处理：

using Microsoft.Extensions.Primitives;
using System.Web;

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// 先添加检查路由的中间件
app.Use(async (context, next) => {
    // 仅当请求路径不是/hello时，返回Bye
    if (!context.Request.Path.StartsWithSegments("/hello"))
    {
        context.Response.ContentType = "text/html";
        await context.Response.WriteAsync("Bye");
        return;
    }
    // 否则继续执行后续中间件（路由匹配）
    await next();
});

app.Map("/hello", async (HttpContext context) => {
    context.Response.ContentType = "text/html";
    await context.Response.WriteAsync("Hello");
});

app.Run();

内容的提问来源于stack exchange，提问作者Abhinay Singh Negi