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