为何在MapControllers()之后配置的中间件无法执行？

先看你的代码示例（已补充后续无效的中间件示例）：

internal class Startup
{
        public void ConfigureServices(IServiceCollection services)
        {
            services.AddControllers();
        }

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

            app.UseEndpoints(endpoint =>
            {
                endpoint.MapControllers(); 
            });
            // 这里添加的任何中间件都不会执行
            app.Run(async context => 
            {
                await context.Response.WriteAsync("This won't run");
            });
        }
}

在ASP.NET Core的中间件管道中，MapControllers() 作为终结点路由的核心部分，会直接短路后续中间件的执行，这就是你遇到问题的原因。

关键机制说明： #

• 终结点路由的执行流程：app.UseRouting() 负责解析请求URL、匹配路由规则；app.UseEndpoints() 则注册所有可用的终结点（包括控制器路由、自定义终结点等）。当请求匹配到某个终结点（比如控制器的路由）时，会立即执行该终结点对应的处理逻辑（控制器的Action方法），处理完成后直接生成响应返回给客户端，不会再回到中间件管道执行后续的中间件。
• MapControllers() 的本质：它是将所有控制器的路由规则注册为终结点，一旦请求匹配上这些规则，管道就会在这里被“截断”，后续的中间件自然没有运行的机会。哪怕请求没有匹配到任何控制器路由，UseEndpoints 本身也会处理404响应，同样不会流转到后续中间件。

替代方案：如果需要在控制器执行后添加逻辑 #

如果要在控制器处理完成后执行特定逻辑，不要在UseEndpoints之后加中间件，而是用ASP.NET Core的过滤器：

• 使用IResultFilter/IAsyncResultFilter：这类过滤器会在控制器Action执行完成、返回结果前后触发，专门用于扩展控制器的生命周期。
• 使用全局过滤器：可以在ConfigureServices中注册，对所有控制器生效；也可以给单个控制器/Action添加特性过滤器，实现局部逻辑。

另外，如果是全局前置逻辑（不依赖路由匹配），可以放在UseRouting()之前的中间件中，但这类逻辑会在路由匹配前运行，和控制器执行没有直接的先后关联。

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