ASP.NET Core中间件短路返回空响应问题及优化咨询

问题 #

我有一个ASP.NET Core Web应用，中间件管道包含多个自定义中间件。我尝试在管道开头添加AllowAnonymousMiddleware，当满足条件时短路后续3个自定义中间件，但现在直接返回时会得到空响应，疑惑为何不继续执行端点路由并返回接口结果？如何让这个中间件仅跳过之后的3个自定义中间件？

当前管道配置代码：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();

    app.UseAuthentication();
    app.UseAuthorization();

    app.UseMiddleware<AllowAnonymousMiddleware>()
        .UseMiddleware<ClientAuthorizedMiddleware>()
        .UseMiddleware<CatalogUserMiddleware>()
        .UseMiddleware<PolicyAllowedMiddleware>();

    app.UseEndpoints(ConfigureEndpoints);
}

AllowAnonymousMiddleware实现：

public class AllowAnonymousMiddleware
{
    private readonly RequestDelegate _next;

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

    public async Task Invoke(HttpContext httpContext)
    {
        var endpoint = httpContext.GetEndpoint();
        var allowsAnonymous = endpoint?.Metadata?.GetMetadata<IAllowAnonymous>();

        if (allowsAnonymous == null)
        {
            await _next(httpContext);
        }

        return;
    }
}

原因分析 #

出现空响应的核心原因是中间件管道的执行顺序：

• AllowAnonymousMiddleware的_next指向的是紧接着的ClientAuthorizedMiddleware，而非后续的UseEndpoints。
• 当不调用_next(httpContext)时，请求会在AllowAnonymousMiddleware这里终止，根本无法到达UseEndpoints环节，自然不会执行端点的操作方法，也就没有响应内容。

解决方案 #

要实现仅跳过指定的3个自定义中间件，需要调整管道结构，把这三个中间件包装到条件分支中，确保允许匿名访问时请求能直接到达端点路由：

方法一：内联中间件控制分支 #

修改Configure方法中的管道配置：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();

    app.UseAuthentication();
    app.UseAuthorization();

    // 新增内联中间件判断是否执行后续三个自定义中间件
    app.Use(async (context, next) =>
    {
        var endpoint = context.GetEndpoint();
        var allowsAnonymous = endpoint?.Metadata?.GetMetadata<IAllowAnonymous>();

        if (allowsAnonymous == null)
        {
            // 需要验证，执行后续三个自定义中间件
            await next(context);
        }
        else
        {
            // 跳过三个中间件，直接执行端点路由
            await next(context);
        }
    })
    .UseMiddleware<ClientAuthorizedMiddleware>()
    .UseMiddleware<CatalogUserMiddleware>()
    .UseMiddleware<PolicyAllowedMiddleware>();

    app.UseEndpoints(ConfigureEndpoints);
}

方法二：重构独立中间件（可选） #

如果希望保留独立的AllowAnonymousMiddleware类，可以将自定义中间件作为分支管道注入：

// 修改Configure中的管道注册
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();

    app.UseAuthentication();
    app.UseAuthorization();

    // 构建自定义中间件分支管道并传入AllowAnonymousMiddleware
    var authPipeline = app.New()
        .UseMiddleware<ClientAuthorizedMiddleware>()
        .UseMiddleware<CatalogUserMiddleware>()
        .UseMiddleware<PolicyAllowedMiddleware>()
        .Build();

    app.UseMiddleware<AllowAnonymousMiddleware>(authPipeline);

    app.UseEndpoints(ConfigureEndpoints);
}

// 修改AllowAnonymousMiddleware实现
public class AllowAnonymousMiddleware
{
    private readonly RequestDelegate _nextEndpoint;
    private readonly RequestDelegate _authPipeline;

    public AllowAnonymousMiddleware(RequestDelegate nextEndpoint, RequestDelegate authPipeline)
    {
        _nextEndpoint = nextEndpoint; // 指向端点路由的管道
        _authPipeline = authPipeline; // 指向三个自定义中间件的分支
    }

    public async Task Invoke(HttpContext httpContext)
    {
        var endpoint = httpContext.GetEndpoint();
        var allowsAnonymous = endpoint?.Metadata?.GetMetadata<IAllowAnonymous>();

        if (allowsAnonymous == null)
        {
            // 执行自定义中间件分支
            await _authPipeline(httpContext);
        }
        
        // 无论是否执行自定义中间件，最终都进入端点路由
        await _nextEndpoint(httpContext);
    }
}

两种方法的核心逻辑一致：确保允许匿名访问时，请求能直接流转到UseEndpoints环节，而非中途终止管道。

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