ASP.NET Core Web API中，为何中间件在app.UseEndpoints()后不执行？

为什么UseEndpoints之后的中间件不会被调用 #

ASP.NET Core的中间件管道是按顺序执行的，UseEndpoints中间件在匹配到对应的端点（比如你的API Action）后，会直接执行端点的业务逻辑，不会再调用后续中间件的next()委托。所以你放在它后面的中间件永远不会被触发。

正确实现端点执行后逻辑的两种方式 #

方式一：利用中间件管道的回溯执行 #

把自定义中间件放在UseEndpoints之前，在中间件内部先调用await next(context)，这段代码会让管道继续走到端点执行，等端点逻辑完成后，会回溯执行next()之后的代码，这部分就是你要的端点执行后的逻辑。

示例代码：

// 自定义中间件
public class PostActionMiddleware
{
    private readonly RequestDelegate _next;

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

    public async Task InvokeAsync(HttpContext context)
    {
        // （可选）这里是端点执行前的逻辑
        
        // 先执行后续管道（包括端点）
        await _next(context);
        
        // 这里就是端点执行后的逻辑
        if (context.Response.StatusCode == StatusCodes.Status200OK)
        {
            // 比如记录响应日志、修改响应内容等操作
            var responseBody = await ReadResponseBody(context);
            // 处理逻辑...
        }
    }

    // 辅助方法：读取响应内容（需要先修改响应流的位置）
    private async Task<string> ReadResponseBody(HttpContext context)
    {
        context.Response.Body.Seek(0, SeekOrigin.Begin);
        var body = await new StreamReader(context.Response.Body).ReadToEndAsync();
        context.Response.Body.Seek(0, SeekOrigin.Begin);
        return body;
    }
}

// 扩展方法方便注册
public static class PostActionMiddlewareExtensions
{
    public static IApplicationBuilder UsePostActionMiddleware(this IApplicationBuilder app)
    {
        return app.UseMiddleware<PostActionMiddleware>();
    }
}

在Startup的Configure方法中注册：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    // 其他中间件（比如UseRouting、UseAuthorization等）
    
    // 把这个中间件放在UseEndpoints之前
    app.UsePostActionMiddleware();

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

方式二：使用端点过滤器（.NET 6+ 推荐） #

如果你的项目是.NET 6及以上版本，推荐用端点过滤器，它专门针对端点的执行前后做处理，比中间件更精准，不会影响整个管道的其他请求。

示例代码：

// 自定义端点过滤器
public class PostEndpointFilter : IEndpointFilter
{
    public async ValueTask<object?> InvokeAsync(EndpointFilterInvocationContext context, EndpointFilterDelegate next)
    {
        // （可选）端点执行前的逻辑
        
        // 执行端点逻辑
        var result = await next(context);
        
        // 端点执行后的逻辑，result是Action的返回值
        if (result is OkObjectResult okResult)
        {
            // 比如处理返回结果、记录日志
            var responseData = okResult.Value;
            // 你的操作...
        }

        return result;
    }
}

注册方式有两种：

1. 全局注册（对所有API控制器生效）：

// 在Program.cs（.NET 6+）或Startup.cs的ConfigureServices中
services.AddControllers(options =>
{
    options.Filters.Add<PostEndpointFilter>();
});

2. 局部注册（仅对特定控制器/Action生效）：

[ServiceFilter(typeof(PostEndpointFilter))]
public class UserController : ControllerBase
{
    [HttpGet]
    public IActionResult GetUsers()
    {
        // 你的Action逻辑
        return Ok(new List<string> { "user1", "user2" });
    }
}

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