ASP.NET Core 6 WebAPI：满足特定条件时跳过后续中间件并正常路由至控制器的实现问题

我来帮你分析和解决这个问题～

你当前的代码核心问题是：当匹配到/login路径时，你直接通过context.Response.WriteAsync返回了响应，却没有继续调用请求管道的后续环节（也就是_next(context)），这导致整个请求到这里就终止了，自然无法到达控制器。要实现「跳过CustomMiddleware2和3，但让请求正常走到控制器」，我们可以用ASP.NET Core的管道分支功能来优雅解决。

方案一：用MapWhen实现精准的管道分支 #

这是最推荐的方式，它能清晰地把需要跳过的中间件隔离到特定分支里，只有当条件不满足时才执行它们。

步骤1：调整中间件注册顺序（Program.cs）

把CustomMiddleware2和3放在MapWhen的分支中，分支的判断条件是请求不需要跳过后续中间件。同时确保路由、控制器相关的中间件注册在所有自定义中间件之后，保证请求最终能流向控制器：

var builder = WebApplication.CreateBuilder(args);

// 添加控制器服务
builder.Services.AddControllers();

var app = builder.Build();

// 先注册CustomMiddleware1
app.UseMiddleware<CustomMiddleware1>();

// 创建分支：仅当路径不是/login时，执行CustomMiddleware2和3
app.MapWhen(context => context.Request.Path != "/login", appBranch =>
{
    appBranch.UseMiddleware<CustomMiddleware2>();
    appBranch.UseMiddleware<CustomMiddleware3>();
});

// 注册路由、授权和控制器路由中间件
app.UseRouting();
app.UseAuthorization();
app.MapControllers();

app.Run();

步骤2：修改CustomMiddleware1的逻辑

现在你可以在CustomMiddleware1里处理自己的业务逻辑（比如日志、参数验证等），不需要直接返回响应，只要确保继续调用_next(context)让请求流向后续管道即可：

public class CustomMiddleware1
{
    private readonly RequestDelegate _next;

    public CustomMiddleware1(RequestDelegate next)
    {
        _next = next;
    }

    public async Task Invoke(HttpContext context)
    {
        if (context.Request.Path == "/login")
        {
            // 这里可以添加你的自定义逻辑，比如记录日志、验证请求等
            Console.WriteLine("检测到/login路径，将跳过后续自定义中间件");
        }

        // 继续执行请求管道，此时如果是/login路径，会直接走到路由和控制器中间件
        await _next(context);
    }
}

方案二：基于自定义标记的灵活分支（适合复杂条件） #

如果你的跳过条件不只是路径（比如需要检查请求头、用户身份等），可以通过HttpContext.Items传递标记，让MapWhen基于这个标记判断是否执行后续中间件：

修改CustomMiddleware1：

public async Task Invoke(HttpContext context)
{
    // 自定义复杂条件判断，比如检查请求头、用户状态等
    bool shouldSkip = context.Request.Path == "/login" 
                      || context.Request.Headers.ContainsKey("Skip-Custom-Middlewares");

    if (shouldSkip)
    {
        // 把标记存入HttpContext.Items，供后续分支判断使用
        context.Items["SkipCustomMiddlewares"] = true;
        Console.WriteLine("满足跳过条件，将跳过后续自定义中间件");
    }

    await _next(context);
}

修改Program.cs中的分支逻辑：

app.MapWhen(context => !(bool?)context.Items["SkipCustomMiddlewares"] ?? false, appBranch =>
{
    appBranch.UseMiddleware<CustomMiddleware2>();
    appBranch.UseMiddleware<CustomMiddleware3>();
});

效果验证 #

现在当请求是/login时，会经过CustomMiddleware1，但不会进入执行CustomMiddleware2和3的分支，直接流向路由和控制器，就能正常访问你写的Login控制器接口了；其他路径则会依次执行三个自定义中间件，再走到控制器。

备注：内容来源于stack exchange，提问作者Saghar Francis