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

来源:这里教程网 时间:2026-02-21 17:30:22 作者:

中间件(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();
<p>if (app.Environment.IsDevelopment())
{
app.UseDeveloperExceptionPage();
}</p><p>app.UseStaticFiles();</p><p>app.UseRouting();</p><p>app.UseAuthentication();
app.UseAuthorization();</p><p>app.MapControllers(); // 或 MapGet, MapPost 等</p><div class="aritcle_card flexRow">
                                                        <div class="artcardd flexRow">
                                                                <a class="aritcle_card_img" href="/ai/1354" title="阿里云AI平台"><img
                                                                                src="https://www.herecours.com/d/file/efpub/2026/21-21/20260221135721179284.jpg" alt="阿里云AI平台"  onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
                                                                <div class="aritcle_card_info flexColumn">
                                                                        <a href="/ai/1354" title="阿里云AI平台">阿里云AI平台</a>
                                                                        <p>阿里云AI平台</p>
                                                                </div>
                                                                <a href="/ai/1354" title="阿里云AI平台" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
                                                        </div>
                                                </div><p>app.Run();</p>

自定义中间件实现

你可以创建自己的中间件来处理特定逻辑。中间件类通常包含一个 InvokeInvokeAsync 方法,并接受 HttpContext 和下一个中间件委托 RequestDelegate

示例:记录请求耗时的中间件

public class RequestTimeMiddleware
{
    private readonly RequestDelegate _next;
<pre class="brush:php;toolbar:false;">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<RequestTimeMiddleware>();

或者写成内联方式(适用于简单逻辑):

app.Use(async (context, next) =>
{
    Console.WriteLine("进入中间件");
    await next();
    Console.WriteLine("离开中间件");
});

基本上就这些。中间件机制让 ASP.NET Core 具备高度可定制性,合理组织中间件顺序能确保应用行为正确且高效。

相关推荐