你真的理解 ASP.NET Core 的中间件吗？搞懂它只需要这一篇

在 ASP.NET Core 的设计中，高性能、高灵活性和模块化并不是偶然结果，而是源于一套非常清晰的架构理念。其中，中间件（Middleware）是整个 Web 框架的核心基础设施之一。

每一个 HTTP 请求，从进入应用到返回响应，都会完整地走过一条由中间件组成的请求管道。日志、认证、异常处理、路由匹配等横切关注点，几乎全部是通过中间件完成的。理解中间件的工作方式，本质上就是在理解 ASP.NET Core 是如何“运转”的。

什么是中间件？

中间件可以理解为一个按顺序执行的请求处理组件。它既可以在请求到达控制器之前做预处理，也可以在响应返回客户端之前做后处理，甚至可以在满足条件时直接终止请求流程，这种行为通常称为“短路”。

每个中间件都拥有一个非常重要的决策权：是否将请求交给下一个中间件继续处理。如果调用了下一个中间件，请求就会继续向后流转；如果没有调用，请求就在当前中间件结束。

从整体来看，中间件形成了一条典型的“双向管道”：请求阶段从第一个中间件一路向后，响应阶段则从最后一个中间件反向返回。这种结构非常像一条流水线，每个节点各司其职，但顺序一旦错了，整个流程就可能失效。

请求管道的执行顺序至关重要

在 ASP.NET Core 中，中间件的执行顺序完全取决于它们在Program.cs中的注册顺序。这一点非常关键，也是很多新手最容易踩坑的地方。

下面是一段常见且合理的中间件配置示例：

app.UseExceptionHandler("/error");// 最先执行，捕获后续所有异常app.UseHttpsRedirection();// 强制 HTTPSapp.UseStaticFiles();// 静态文件直接返回，不进入路由app.UseRouting();// 路由匹配app.UseAuthentication();// 认证app.UseAuthorization();// 授权app.MapControllers();// 执行 MVC 控制器

这里的顺序并不是“看着顺眼”排出来的，而是有明确依赖关系的。例如，如果把UseStaticFiles()放到UseRouting()后面，静态资源就可能被当作 API 路由处理；如果把认证放在授权之后，逻辑本身就已经不成立了。

中间件的顺序，本质上是一种架构约束，而不是代码风格问题。

常见内置中间件及其职责

ASP.NET Core 自带了大量成熟、稳定的中间件，它们覆盖了 Web 应用中最核心的基础能力。

UseRouting负责解析请求 URL 并匹配终结点；UseAuthentication和UseAuthorization负责身份验证和权限校验；UseStaticFiles用于高效返回图片、脚本等静态资源；UseExceptionHandler提供统一的异常兜底机制；UseHttpsRedirection则保证请求始终通过安全通道访问。

这些中间件组合在一起，构成了现代 Web 应用在安全性、稳定性和性能上的基础保障。

中间件的三种常见形式

内联中间件（Inline Middleware）

内联中间件直接通过Use方法在Program.cs中定义，适合处理简单、一次性的逻辑：

app.Use(async(context, next) =>{Console.WriteLine("Before");awaitnext();// 调用下一个中间件Console.WriteLine("After");});

这种写法非常直观，也很好地体现了“请求进来一次、响应返回一次”的双向执行特性。

终结中间件（Terminal Middleware）

终结中间件通过Run注册，不会调用next()，意味着请求在此直接结束：

app.Run(asynccontext =>{awaitcontext.Response.WriteAsync("Handled here.");});

它常用于健康检查、极简 API 或调试场景，一旦执行，后续中间件将不再参与请求处理。

自定义中间件类

当中间件逻辑开始变复杂，或者需要在多个项目中复用时，最好的方式是将其封装为独立的中间件类：

public class RequestLoggingMiddleware{private readonly RequestDelegate _next;public RequestLoggingMiddleware(RequestDelegate next){_next = next;}public async Task InvokeAsync(HttpContext context){var start = DateTime.UtcNow;await _next(context);var duration = DateTime.UtcNow - start;Console.WriteLine($"{context.Request.Path} took {duration.TotalMilliseconds}ms");}}

注册方式也非常简单：

app.UseMiddleware();

这种形式是实际项目中最推荐的做法，结构清晰、职责明确，也方便测试和维护。

短路机制：在合适的地方终止请求

中间件并不一定要把请求交给下一个节点。在满足特定条件时，可以直接返回响应，这就是所谓的“短路”机制：

.Use(async (context, next) =>{if (context.Request.Headers["X-API-Key"] != "secret"){context.Response.StatusCode = StatusCodes.Status403Forbidden;return;}await next();});

这种模式在认证校验、限流、防刷、IP 黑名单等场景中非常常见。它的核心价值在于：尽早失败，减少无效消耗。