中间件是ASP.NET Core处理HTTP请求的核心组件,按顺序构成管道,每个中间件可执行逻辑、处理响应或短路流程。通过Program.cs中的app.Use...方法注册,如UseRouting、UseAuthentication、UseStaticFiles等,执行顺序决定行为。自定义中间件通过类或内联函数实现,如记录请求耗时,并用app.UseMiddleware注册。合理组织顺序确保应用高效正确运行。

中间件(Middleware)是 ASP.NET Core 中用于处理 HTTP 请求和响应的核心组件。它按照顺序组成一个管道,每个中间件负责特定任务,比如身份验证、异常处理、静态文件服务等。请求沿着这个管道流入,响应则逆向流出。
中间件的基本概念
每一个中间件都位于请求处理管道中,可以:
- 在将请求传递给下一个中间件之前执行逻辑
- 在下一个中间件处理完请求后,对响应进行操作
- 短路管道,不再调用后续中间件(例如返回错误或直接响应)
中间件通常封装在单独的类中,并通过扩展方法注册到应用程序的请求管道。
构建请求管道
在 ASP.NET Core 中,请求管道是在 Program.cs 文件中使用 app.Use... 系列方法构建的。执行顺序非常重要,因为中间件是按定义顺序依次执行的。
常见用法包括:
- app.UseRouting():启用路由匹配,必须放在 UseEndpoints 前面
- app.UseAuthentication():启用身份认证
- app.UseAuthorization():启用授权检查
- app.UseStaticFiles():提供对静态文件(如 js、css、图片)的访问
- app.UseExceptionHandler():捕获异常并返回友好错误页
- app.UseEndpoints() 或 app.MapControllers():映射控制器、Razor 页面或最小 API 路由
示例代码:
var builder = WebApplication.CreateBuilder(args); var app = builder.Build();if (app.Environment.IsDevelopment()) { app.UseDeveloperExceptionPage(); }
app.UseStaticFiles();
app.UseRouting();
app.UseAuthentication(); app.UseAuthorization();
app.MapControllers(); // 或 MapGet, MapPost 等
app.Run();
自定义中间件实现
你可以创建自己的中间件来处理特定逻辑。中间件类通常包含一个 Invoke 或 InvokeAsync 方法,并接受 HttpContext 和下一个中间件委托 RequestDelegate。
示例:记录请求耗时的中间件
public class RequestTimeMiddleware
{
private readonly RequestDelegate _next;
public RequestTimeMiddleware(RequestDelegate next)
{
_next = next;
}
public async Task InvokeAsync(HttpContext context)
{
var startTime = DateTime.Now;
await _next(context); // 继续执行后续中间件
var duration = DateTime.Now - startTime;
Console.WriteLine($"请求耗时: {duration.TotalMilliseconds}ms");
}}
注册该中间件:
app.UseMiddleware();
或者写成内联方式(适用于简单逻辑):
app.Use(async (context, next) =>
{
Console.WriteLine("进入中间件");
await next();
Console.WriteLine("离开中间件");
});基本上就这些。中间件机制让 ASP.NET Core 具备高度可定制性,合理组织中间件顺序能确保应用行为正确且高效。










