ASP.NET Core中的中间件是什么？如何使用？

ASP.NET Core中间件是请求处理管道的核心，通过IApplicationBuilder按顺序注册，形成处理链条。每个中间件可选择是否传递请求，实现模块化、解耦和可复用的横切关注点，如认证、日志等。常见注册方式包括Use、Run、Map和扩展方法，执行顺序直接影响应用行为，如错误处理需前置，静态文件处理可短路后续流程。自定义中间件可通过约定类、Lambda表达式或Run实现，提升灵活性和维护性。

说起ASP.NET Core的中间件，这玩意儿简直是整个框架的灵魂所在。简单来说，它就是一系列按特定顺序排列的组件，它们串联起来处理HTTP请求和响应。每个中间件都能选择是否处理请求、修改请求或响应，然后决定是否将请求传递给管道中的下一个中间件。它让我们的应用程序能够以一种高度模块化和可插拔的方式来构建，极大地提升了灵活性和可维护性。至于怎么用，核心就是在应用程序的启动配置里，通过

IApplicationBuilder

解决方案

在ASP.NET Core中，中间件的运用是贯穿整个请求生命周期的核心机制。它将HTTP请求处理过程拆解成一个个独立的、可复用的单元，每个单元（即中间件）只负责完成一项特定任务。

首先，中间件的注册和配置通常发生在

Startup.cs

Configure

Program.cs

IApplicationBuilder

• Use

  登录后复制
  方法：这是最常用的一种，它允许你将一个中间件添加到管道中，并且该中间件可以选择是否将请求传递给管道中的下一个中间件。它接受一个

  RequestDelegate

  登录后复制
  作为参数，通常我们用lambda表达式来定义。例如，

  app.Use(async (context, next) => { /* do something before */ await next(); /* do something after */ });

  登录后复制
  。这里的

  next

  登录后复制
  委托就是管道中的下一个中间件。

• Run

  登录后复制
  方法：这个方法用于添加一个终端中间件。一旦请求到达

  Run

  登录后复制
  方法定义的中间件，它就不会再传递给管道中的下一个中间件了，请求处理流程在此结束。所以，

  Run

  登录后复制
  通常放在管道的末端，例如

  app.Run(async context => { await context.Response.WriteAsync("Hello from Run!"); });

  登录后复制
  。

• Map

  登录后复制
  方法：

  Map

  登录后复制
  允许你根据请求路径来分支管道。如果请求路径匹配，就会执行

  Map

  登录后复制
  内部定义的中间件管道，否则跳过。这对于为特定路径提供不同的处理逻辑非常有用。比如，

  app.Map("/api", apiApp => { apiApp.UseMiddleware<ApiAuthenticationMiddleware>(); });

  登录后复制
  。

• MapWhen

  登录后复制
  方法：与

  Map

  登录后复制
  类似，但它根据一个谓词函数来决定是否分支管道，而不是简单的路径匹配。这提供了更大的灵活性，可以基于任何请求属性进行条件判断。
• 扩展方法：ASP.NET Core自带了许多常用的中间件，它们通常以

  UseXxx

  登录后复制
  的形式提供，例如

  app.UseRouting()

  登录后复制
  、

  app.UseAuthentication()

  登录后复制
  、

  app.UseAuthorization()

  登录后复制
  、

  app.UseStaticFiles()

  登录后复制
  等。这些都是预构建的中间件，可以直接拿来用。

当我们把这些中间件按序添加到

IApplicationBuilder

为什么我们需要ASP.NET Core中间件？它的核心价值在哪里？

在我看来，ASP.NET Core中间件的出现，彻底改变了我们构建Web应用的方式，它的核心价值在于解耦、模块化和可组合性。想想看，以前在ASP.NET Web Forms或MVC 5时代，很多跨领域的关注点，比如认证、授权、日志、错误处理，可能需要通过

HttpModule

HttpHandler

中间件机制则提供了一个优雅的解决方案。它把这些横切关注点从核心业务逻辑中剥离出来，封装成一个个独立的、可插拔的组件。比如，你不需要在每个Action里都写认证逻辑，只需在管道前面加上一个认证中间件，所有后续请求都会先经过它。这种设计哲学，让应用程序的各个部分各司其职，互不干扰。当我们需要添加新功能或者修改现有功能时，往往只需要添加、移除或调整中间件的顺序，而不需要大动干戈地修改核心代码。这不仅仅是提升了开发效率，更重要的是，它极大地增强了系统的可扩展性和健壮性。对我来说，这就像是搭积木，每一个中间件都是一块积木，我们可以根据需要自由组合，搭建出各种功能的房子，而不是每次都从零开始雕刻一整块石头。

如何自定义一个ASP.NET Core中间件？有哪些常见的实现方式？

自定义中间件是ASP.NET Core开发中非常常见的需求，毕竟框架提供的那些通用中间件不可能满足所有业务场景。实现自定义中间件主要有以下几种方式，每种都有其适用场景：

1. 基于约定（Convention-based）的中间件： 这是最常见、也相对简单的一种方式。你只需要创建一个类，满足以下两个条件：

• 构造函数接受一个

  RequestDelegate

  登录后复制
  类型的参数，用于注入管道中的下一个中间件。
• 包含一个名为

  Invoke

  登录后复制
  或

  InvokeAsync

  登录后复制
  的公共方法，该方法接受一个

  HttpContext

  登录后复制
  参数，并且返回

  Task

  登录后复制
  。

public class MyCustomMiddleware
{
    private readonly RequestDelegate _next;

    public MyCustomMiddleware(RequestDelegate next)
    {
        _next = next;
    }

    public async Task InvokeAsync(HttpContext context)
    {
        // 在请求到达下一个中间件之前执行的逻辑
        Console.WriteLine($"请求进入 MyCustomMiddleware: {context.Request.Path}");

        await _next(context); // 调用管道中的下一个中间件

        // 在请求从下一个中间件返回之后执行的逻辑
        Console.WriteLine($"请求离开 MyCustomMiddleware: {context.Request.Path}");
    }
}

然后在

Configure

app.UseMiddleware<MyCustomMiddleware>();

或者，为了更方便，通常我们会写一个扩展方法：

慧中标AI标书

慧中标AI标书是一款AI智能辅助写标书工具。

120

查看详情

public static class MyCustomMiddlewareExtensions
{
    public static IApplicationBuilder UseMyCustomMiddleware(this IApplicationBuilder builder)
    {
        return builder.UseMiddleware<MyCustomMiddleware>();
    }
}
// 使用时：app.UseMyCustomMiddleware();

这种方式清晰直观，适用于需要访问服务（通过构造函数注入）或在请求前后执行逻辑的场景。

2. 直接使用Lambda表达式（Inline Middleware）： 对于一些简单、不涉及复杂逻辑或无需从DI容器中获取服务的中间件，可以直接使用

app.Use()

app.Use(async (context, next) =>
{
    Console.WriteLine($"Inline Middleware - Before: {context.Request.Path}");
    await next();
    Console.WriteLine($"Inline Middleware - After: {context.Request.Path}");
});

这种方式非常简洁，特别适合快速原型开发或处理一些局部性的逻辑。但如果逻辑复杂，或者需要在多个地方复用，建议还是封装成独立的类。

3. 使用

app.Run()

app.Run()

app.Run(async context =>
{
    await context.Response.WriteAsync("Hello from the end of the pipeline!");
});

这通常用于处理404 Not Found、健康检查或简单的根路径响应等场景。

选择哪种方式取决于你的具体需求。如果需要高度封装、可复用且可能需要依赖注入，那么基于约定的类是首选。如果只是一个临时的、简单的逻辑，lambda表达式会更方便。而

app.Run()

ASP.NET Core中间件的执行顺序如何影响应用程序行为？

中间件的执行顺序，这是个极其关键但又常常让人犯错的地方。我见过不少因为中间件顺序不对导致应用行为异常的案例。在ASP.NET Core的请求处理管道中，中间件的注册顺序就是它的执行顺序。这个规则简单粗暴，却决定了请求和响应流经各个组件的路径。

想象一下，中间件管道就像一个生产流水线。一个HTTP请求从一端进入，先经过第一个工位（第一个中间件），然后是第二个、第三个……直到最后一个工位。每个工位都有机会对产品（请求）进行加工。当所有工位都走完，或者某个工位直接把产品打包送出（短路），流水线才算结束。

1. 顺序的重要性：

• 依赖关系： 很多中间件都有隐式的依赖关系。例如，认证中间件（

  UseAuthentication

  登录后复制
  ）通常需要放在授权中间件（

  UseAuthorization

  登录后复制
  ）之前，因为授权决策往往需要基于已认证的用户身份。同样，路由中间件（

  UseRouting

  登录后复制
  ）和终结点中间件（

  UseEndpoints

  登录后复制
  ）必须在身份验证和授权之后，以便这些安全特性能够作用于已匹配的路由。
• 短路效应：

  Run

  登录后复制
  方法以及一些特殊的

  Use

  登录后复制
  方法（比如

  UseStaticFiles

  登录后复制
  在找到文件后）会短路管道，这意味着它们之后的中间件将不会被执行。如果一个短路中间件被放在了不恰当的位置，它可能会阻止后续重要的中间件（如路由、授权）发挥作用，导致请求无法被正确处理。比如，如果你把

  UseStaticFiles

  登录后复制
  放在了

  UseRouting

  登录后复制
  之后，那静态文件请求就不会经过路由，这通常是没问题的。但如果你把一个自定义的、总是短路请求的中间件放在了管道最前面，那你的API控制器可能永远也接收不到请求了。
• 日志和错误处理： 错误处理中间件（

  UseExceptionHandler

  登录后复制
  或

  UseDeveloperExceptionPage

  登录后复制
  ）通常应该放在管道的最前面。这样，它就能捕获管道中后续所有中间件抛出的异常。如果把它放在后面，它就无法捕获它前面中间件的异常了。日志中间件也类似，如果你想记录整个请求生命周期，它就应该尽可能靠前。

2. 典型的中间件顺序： 虽然没有一成不变的“圣经”顺序，但ASP.NET Core应用通常遵循一个推荐的模式：

1. 错误处理 (

   UseDeveloperExceptionPage

   登录后复制
   /

   UseExceptionHandler

   登录后复制
   )：越靠前越好，以捕获所有后续异常。
2. HSTS/HTTPS重定向 (

   UseHsts

   登录后复制
   /

   UseHttpsRedirection

   登录后复制
   )：安全相关的，尽早处理。
3. 静态文件 (

   UseStaticFiles

   登录后复制
   )：如果请求是静态文件，直接处理并短路。
4. 路由 (

   UseRouting

   登录后复制
   )：匹配请求URL到具体的终结点。
5. CORS (

   UseCors

   登录后复制
   )：处理跨域请求。
6. 认证 (

   UseAuthentication

   登录后复制
   )：验证用户身份。
7. 授权 (

   UseAuthorization

   登录后复制
   )：根据身份决定用户是否有权限访问资源。
8. 会话 (

   UseSession

   登录后复制
   )：如果需要会话状态。
9. 终结点 (

   UseEndpoints

   登录后复制
   )：执行匹配到的终结点（如MVC控制器Action、Razor Pages、Minimal API）。

这个顺序并非固定不变，但它提供了一个非常好的起点。理解每个中间件的作用以及它们之间的依赖关系，是正确配置管道的关键。我通常会在开发新功能或者排查问题时，特别留意中间件的注册顺序，这往往能帮助我快速定位问题所在。一旦顺序乱了，整个应用的表现就会变得难以预测，甚至直接崩溃。

以上就是ASP.NET Core中的中间件是什么？如何使用？的详细内容，更多请关注php中文网其它相关文章！