C#的中间件(Middleware)是什么？如何在ASP.NET Core中构建请求管道？-C#.Net教程-PHP中文网

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

星降

发布： 2025-11-13 17:21:07

原创

657人浏览过

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

c#的中间件(middleware)是什么？如何在asp.net core中构建请求管道？

中间件（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>
                    <div class="aritcle_card">
                        <a class="aritcle_card_img" href="/ai/1655">
                            <img src="https://img.php.cn/upload/ai_manual/000/969/633/68b6d69663ee2218.png" alt="有道小P">
                        </a>
                        <div class="aritcle_card_info">
                            <a href="/ai/1655">有道小P</a>
                            <p>有道小P，新一代AI全科学习助手，在学习中遇到任何问题都可以问我。</p>
                            <div class="">
                                <img src="/static/images/card_xiazai.png" alt="有道小P">
                                <span>64</span>
                            </div>
                        </div>
                        <a href="/ai/1655" class="aritcle_card_btn">
                            <span>查看详情</span>
                            <img src="/static/images/cardxiayige-3.png" alt="有道小P">
                        </a>
                    </div>
                <p>app.UseAuthentication();
app.UseAuthorization();</p><p>app.MapControllers(); // 或 MapGet, MapPost 等</p><p>app.Run();

登录后复制

自定义中间件实现

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

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

public class RequestTimeMiddleware
{
    private readonly RequestDelegate _next;
<pre class="brush:php;toolbar:false;"><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 具备高度可定制性，合理组织中间件顺序能确保应用行为正确且高效。

以上就是C#的中间件(Middleware)是什么？如何在ASP.NET Core中构建请求管道？的详细内容，更多请关注php中文网其它相关文章！