C#的中间件(Middleware)是什么?如何在ASP.NET Core中构建请求管道?

中间件是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();

自定义中间件实现

你可以创建自己的中间件来处理特定逻辑。中间件类通常包含一个 InvokeInvokeAsync 方法,并接受 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 具备高度可定制性,合理组织中间件顺序能确保应用行为正确且高效。