中间件是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();
<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/1547" title="Favird No-Code Tools"><img
src="https://img.php.cn/upload/ai_manual/000/969/633/68b7a0e82b449361.png" alt="Favird No-Code Tools" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/ai/1547" title="Favird No-Code Tools">Favird No-Code Tools</a>
<p>无代码工具的聚合器</p>
</div>
<a href="/ai/1547" title="Favird No-Code Tools" 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 具备高度可定制性,合理组织中间件顺序能确保应用行为正确且高效。









