罗罗编程学习记录
本页内容 展开查看

06.3.1.1 请求生命周期与中间件管道

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.3 .NET 后端 / 06.3.1 ASP.NET Core 运行时与管道

本节要解决的问题

  • 一个请求如何穿过 ASP.NET Core 中间件管道?
  • 中间件如何编写,执行顺序为什么关键?
  • 管道与 MVC/端点层、过滤器层如何分工?

版本前提:本节以 .NET 8 / ASP.NET Core 8 为准。

06.3.1.1-001 ASP.NET Core 请求管道是什么结构?

一句话结论

请求按中间件注册顺序依次进入管道,每个中间件可调用下一个 next 或短路;响应沿反序返回,形成洋葱模型。

概念解释

管道由一组有序中间件组成:请求从外层向内层传递,响应从内层向外层返回。中间件可以修改请求、记录耗时、处理异常、做认证授权,或直接产生响应。

图示

请求 → [异常处理] → [日志/路由] → [认证] → [授权] → [端点]
响应 ←─────────────────────────────────────────────── 反序返回

示例

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.Use(async (context, next) =>
{
    // 进入下一个中间件之前
    await next();
    // 响应返回之后
});
app.MapGet("/", () => "hello");
app.Run();

常见误区

  • 认为中间件是并行执行:管道是顺序链,await next() 决定进入下游。
  • 响应返回阶段的代码不执行:只要调用了 next,下游返回后外层代码仍会执行。

追问

  • 中间件注册顺序由什么决定?Program.cs / Startup 中 Use* 的调用顺序。
  • 管道短路后还会走下游吗?不调用 next 且自行写入响应,下游中间件不再执行。

06.3.1.1-002 中间件如何编写,next() 语义是什么?

一句话结论

中间件是一个委托:接收 HttpContext 与 next 委托;调用 next() 把请求交给下游,不调用则短路;下游返回后可处理响应。

概念解释

两种写法:内联委托(app.Use)与约定式中间件类(含 Invoke/InvokeAsync 构造)。next 代表管道剩余部分,await next() 后才是响应回阶段。

示例

// 约定式中间件
public class TimingMiddleware
{
    private readonly RequestDelegate _next;
    public TimingMiddleware(RequestDelegate next) => _next = next;

    public async Task InvokeAsync(HttpContext context)
    {
        var sw = Stopwatch.StartNew();
        await _next();
        sw.Stop();
        Console.WriteLine($"{context.Request.Path} {sw.ElapsedMilliseconds}ms");
    }
}

// 注册
app.UseMiddleware<TimingMiddleware>();

常见误区

  • 忘记 await next():下游不执行,管道挂起或行为异常。
  • 在 next() 之后读取请求体:请求流可能已被消费。

追问

  • 中间件构造函数与 Invoke 注入有何区别?构造函数在应用生命周期解析(通常单例),Invoke 参数可解析 Scoped 服务。
  • 中间件可以返回不调用 next 的响应吗?可以,那就是终端短路。

06.3.1.1-003 中间件执行顺序为什么关键?

一句话结论

顺序决定每层能看到什么、能拦截什么:异常处理必须最外层,认证先于授权,路由先于认证授权,端点在最内层;顺序颠倒会导致鉴权失效或无法获取路由信息。

概念解释

  • 异常处理:最外层兜底捕获下游异常。
  • 路由:先匹配端点,认证授权才能知道要求什么权限。
  • 认证 → 授权:先识别身份,再判断权限。
  • 静态文件、CORS、健康检查等按依赖位置放置。

示例

app.UseExceptionHandler("/error");   // 最外
app.UseHttpsRedirection();
app.UseRouting();                    // 路由匹配
app.UseCors();
app.UseAuthentication();             // 认证
app.UseAuthorization();              // 授权
app.MapControllers();                // 端点

常见误区

  • UseAuthorization 放在 UseAuthentication 前:没有身份上下文,授权失败。
  • 异常处理中间件放在内层:捕获不到更外层中间件的异常。

追问

  • Minimal API 中顺序仍重要吗?重要:WebApplication 同样按注册顺序构建管道。
  • 顺序错误如何排查?看 401/403 出现位置、日志中路由信息是否可用。

06.3.1.1-004 Use / Run / Map 三者区别?

一句话结论

Use 加入可继续下游的中间件;Run 是终端中间件,直接结束管道;Map 按路径分支到子管道,匹配后进入映射分支。

概念解释

  • Use(Func<HttpContext, Func<Task>, Task>):可调用 next。
  • Run(RequestDelegate):不调用 next,终端。
  • Map(path, branch):路径匹配时把请求交给分支管道,分支独立短路。

示例

app.Use(async (ctx, next) => { /* 通用处理 */ await next(); });
app.Map("/admin", branch => branch.UseAuthorization());
app.Run(async context => await context.Response.WriteAsync("terminal"));

常见误区

  • 在 Map 分支里期待继续走主管道:分支内部独立,主管道剩余部分不再进入。
  • 把 Run 当普通中间件注册在 Use 前:其后中间件全部不执行。

追问

  • MapWhen 是什么?按条件(非路径)分支到子管道。
  • Map 与路由端点什么关系?Map 是管道层路径分支;控制器/Minimal API 端点是路由层匹配。

06.3.1.1-005 终端中间件与短路是什么?

一句话结论

终端中间件自行产生响应且不调用 next,管道到此结束;短路指任一层中间件不进入下游直接响应,常用于异常、404、限流与条件拒绝。

概念解释

短路请求不再经过后续中间件与端点;响应由当前中间件写入。短路位置越靠外,下游能力(鉴权、路由)越不会执行,必须确认是否有意为之。

示例

app.Use(async (context, next) =>
{
    if (context.Request.Path == "/health")
    {
        context.Response.StatusCode = 200;
        await context.Response.WriteAsync("ok");
        return; // 短路
    }
    await next();
});

常见误区

  • 短路后仍期望后续日志/审计中间件执行:它们在下游,不会执行。
  • 短路时未设置 StatusCode:响应状态可能停留在默认值。

追问

  • 端点映射(MapGet)算不算短路?算:终端端点产生响应。
  • 短路中间件如何记录指标?在本层自行打点,不能依赖下游日志。

06.3.1.1-006 异常处理中间件放哪里?

一句话结论

异常处理放在管道最外层,包住所有下游中间件与端点;未捕获异常在此转换为错误响应并记录日志,避免框架默认开发页暴露到生产。

概念解释

  • 位置:第一个 Use 之一,确保下游任意异常都能被捕获。
  • 行为:记录 ERROR 日志 + traceId,生产返回通用 ProblemDetails/错误体,不返回堆栈。
  • 开发环境可显示详细异常页,生产关闭。

示例

app.UseExceptionHandler(errApp =>
{
    errApp.Run(async ctx =>
    {
        ctx.Response.StatusCode = 500;
        await ctx.Response.WriteAsJsonAsync(new { code = "INTERNAL_ERROR" });
    });
});

常见误区

  • 异常处理器注册在认证/端点之后:外层抛出的异常捕获不到。
  • 生产保留开发异常页:泄露堆栈与路径。

追问

  • UseStatusCodePages 作用?为 400-599 无响应体的状态码补充页面/响应,与异常处理互补。
  • 业务异常如何映射?异常处理器按异常类型映射状态码与错误码。

06.3.1.1-007 认证与授权中间件顺序?

一句话结论

先 UseAuthentication(识别身份、填充 User),再 UseAuthorization(基于身份与策略判断权限);顺序颠倒则授权时没有已认证主体。

概念解释

  • 认证:解析令牌/Cookie,构造 ClaimsPrincipal 放入 HttpContext.User。
  • 授权:读取用户身份与资源要求,执行策略/角色检查。
  • 路由必须在两者之前,授权策略才能拿到端点元数据(角色、策略名)。

常见误区

  • 把授权放在认证前:User 未初始化,策略判断失败。
  • 跳过认证中间件直接用 [Authorize]:注解不会自行解析令牌。

追问

  • 认证中间件解析失败会抛异常吗?通常填充未认证身份,由授权返回 401/403。
  • 自定义鉴权逻辑写在哪?可在授权策略中,或服务层补资源归属校验。

06.3.1.1-008 中间件与过滤器(Filter)的区别?

一句话结论

中间件运行在管道层,面向所有请求,与具体框架无关;过滤器运行在 MVC/端点层,绑定到控制器/动作/端点,可访问模型绑定、Action 参数与结果。

对比

维度 中间件 过滤器
层级 HTTP 管道 MVC/端点管线
粒度 全局 控制器/动作/端点
可访问 HttpContext Action 参数、模型状态、结果
典型用途 异常、日志、认证、CORS 授权、缓存、模型校验、结果定制

常见误区

  • 把只能在 Action 层做的事(读模型绑定结果)放到中间件:此时还没绑定。
  • 用过滤器实现全局管道横切:过滤器覆盖不到非 MVC 端点。

追问

  • Minimal API 用什么承接过滤器语义?端点过滤器(endpoint filter),见 06.3.1.3。
  • 认证为什么是中间件而不是过滤器?它需要在路由/端点确定前建立全局身份上下文。

06.3.1.1-009 内联中间件与约定式中间件类如何选择?

一句话结论

简单一次性逻辑用内联 Use;可复用、需要构造依赖与清晰职责时写成中间件类并注册到管道;复杂中间件类便于单元测试与复用。

概念解释

  • 内联:app.Use(async (context, next) => ...),适合日志、计时等薄逻辑。
  • 约定类:构造函数接收管道与单例依赖,InvokeAsync 接收 Scoped 服务;通过 UseMiddleware<T>() 注册。

示例

// 内联
app.Use(async (ctx, next) => { await next(); });

// 类中间件
app.UseMiddleware<RequestLoggingMiddleware>();

常见误区

  • 中间件类构造函数解析 Scoped 服务:生命周期错误,得到捕获依赖。
  • 内联逻辑膨胀成数百行:应抽成类与独立测试。

追问

  • 中间件类实例何时创建?应用启动时按注册创建(通常单例),Invoke 每请求执行。
  • 中间件能从 DI 取 DbContext 吗?在 InvokeAsync 参数中取 Scoped,不在构造函数取。

06.3.1.1-010 中间件能否解析 Scoped 服务?

一句话结论

可以,但只能在 InvokeAsync(每请求执行)的参数中解析;构造函数只解析应用生命周期(Singleton)服务,直接在构造函数取 Scoped 会造成捕获依赖。

概念解释

中间件实例本身在应用生命周期内创建。构造函数注入的服务生命周期被固定;若注入 Scoped 服务,该 Scoped 会被单例长期持有,等于被提升为单例,产生并发与状态错误。

示例

public class MyMiddleware
{
    public MyMiddleware(RequestDelegate next, ILogger<MyMiddleware> logger) { } // 单例安全

    public async Task InvokeAsync(HttpContext ctx, ICurrentUser user) // Scoped 每请求
    {
        await _next(ctx);
    }
}

常见误区

  • 构造函数注入 DbContext:Scoped 被单例捕获,跨请求复用同一上下文。
  • 认为 Use 内联委托参数也能任意取 Scoped:内联中间件执行在请求范围内,可从 context.RequestServices 解析。

追问

  • 如何从 context.RequestServices 解析 Scoped?ctx.RequestServices.GetService<T>(),注意服务定位器反模式的使用边界。
  • 开发环境如何发现捕获依赖?开启作用域校验(见 06.3.1.2)。

06.3.1.1-011 一个请求从 Host 到响应的完整流程?

一句话结论

Host 启动绑定 Kestrel → 请求进入管道中间件链 → 路由匹配端点 → 认证授权 → 模型绑定与 Action/端点执行 → 结果序列化 → 响应逆序穿过管道返回。

原理流程

  1. Kestrel 接收连接,构造 HttpContext。
  2. 管道中间件依次处理(异常、日志、CORS、路由、认证、授权)。
  3. 路由选出端点;MVC/端点层绑定模型、校验、执行过滤器与 Action。
  4. Action 返回结果,格式化写响应。
  5. 响应逆序经过剩余中间件,返回客户端。

图示

Kestrel → 异常/日志 → 路由 → CORS → 认证 → 授权
  → 模型绑定 → 过滤器 → Action/Endpoint → 结果格式化 → 响应返回

常见误区

  • 把模型绑定放在中间件阶段:绑定发生在路由确定之后的端点层。
  • 认为静态文件不走管道:静态文件中间件也是管道一环,可短路。

追问

  • 反向代理(IIS/Nginx)在哪个位置?在 Kestrel 之前,转发原始连接信息。
  • 端点选中后还能被管道拦截吗?授权与资源校验可在进入 Action 前后拦截。

06.3.1.1-012 IApplicationBuilder 与管道构建?

一句话结论

IApplicationBuilder 收集中间件委托链,Build() 生成最终请求委托;每个 Use/Map 往管道追加步骤,顺序即执行顺序。

概念解释

构建阶段:Configure/WebApplication 向 builder 注册中间件;Build() 把委托串成链。请求运行时由根委托按链调用。WebApplication 内部封装了 builder 与启动。

常见误区

  • 运行时动态往已 Build 的管道加中间件:无效,管道在启动时定型。
  • 中间件顺序在注册后可随意调换:需调整注册代码并重启。

追问

  • 多分支管道如何构建?Map 为分支创建独立 builder,构建子委托。
  • IApplicationLifetime 与 builder 关系?前者控制应用启停,后者只构建请求管道。

06.3.1.1-013 开发环境与生产环境中间件差异?

一句话结论

按 IWebHostEnvironment 判断环境:开发环境启用详细异常页、开发者异常页;生产环境用全局异常处理器、HSTS、压缩与安全头,不暴露内部细节。

概念解释

  • 开发:DeveloperExceptionPage、环境变量配置、详细日志。
  • 生产:异常兜底响应、HSTS、HTTPS 重定向、诊断端点受限。
  • 环境名通过 ASPNETCORE_ENVIRONMENT 设置。

示例

if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}
else
{
    app.UseExceptionHandler("/error");
    app.UseHsts();
}

常见误区

  • 生产误开开发者异常页:泄露堆栈、配置与路径。
  • 环境判断写死字符串:用 IsDevelopment()/IsProduction() 扩展方法。

追问

  • Staging 环境如何配置?自定义环境名 + IsEnvironment("Staging")。
  • 环境差异会影响中间件顺序吗?条件注册仍需保持主干顺序正确。

06.3.1.1-014 中间件中的异步与线程阻塞风险?

一句话结论

中间件必须 await 异步委托,不阻塞调用线程;同步阻塞(.Result/.Wait())会造成线程池饥饿与死锁风险,IO 与下游调用一律异步等待。

概念解释

ASP.NET Core 基于线程池处理请求;阻塞等待异步结果占用线程不释放,高并发下吞吐下降。管道中所有 IO(读请求体、调下游、写响应)都应异步。

示例

// 正确
await next();
// 危险
next().Wait(); // 阻塞线程

常见误区

  • 在中间件里同步读大请求体再异步转发:占用线程与内存。
  • 异常处理器内忘记 await 异步写响应。

追问

  • 同步 CPU 密集工作怎么办?放到队列/后台服务,不占请求线程;必要时用 Task.Run 需评估线程池。
  • 如何识别阻塞?日志看线程池队列、请求线程长时间占用。

06.3.1.1-015 管道如何观测耗时?

一句话结论

外层中间件记录起止时间与下游耗时,配合 Activity/日志埋点;指标按路径/状态码聚合 P95/P99 与错误率,慢请求记录详细上下文。

概念解释

  • 计时:外层中间件 Stopwatch 包住 next()。
  • 追踪:接入 DiagnosticListener/OpenTelemetry,按请求建立 Activity。
  • 指标:QPS、耗时分位、状态码分布;慢请求样本进日志。

示例

app.Use(async (context, next) =>
{
    var sw = Stopwatch.StartNew();
    await next();
    app.Logger.LogInformation("{Path} {Status} {Ms}",
        context.Request.Path, context.Response.StatusCode, sw.ElapsedMilliseconds);
});

常见误区

  • 在每个下游调用零散打点却没有请求级总耗时:看不出整体链路。
  • 日志记录完整请求体:敏感信息与体积问题。

追问

  • 跨服务耗时如何关联?traceId 透传,各段 Activity 挂到同一 Trace。
  • 慢请求阈值怎么定?按接口分位基线,超过阈值采样记录。

06.3.1.1-016 MapWhen / 分支中间件怎么用?

一句话结论

MapWhen 基于谓词(方法、路径、头、查询)把请求分支到子管道;分支内独立注册中间件并短路,不满足谓词继续主管道。

概念解释

  • Map:按路径前缀分支。
  • MapWhen:按任意 HttpContext 条件分支。
  • 分支 builder 内的中间件只对匹配请求生效。

示例

app.MapWhen(ctx => ctx.Request.Path.StartsWithSegments("/api/v2"),
    branch => branch.UseMiddleware<Version2Middleware>());

常见误区

  • 分支内期待回主管道:子管道自成体系。
  • 谓词读取请求体后不还原:下游无法再读。

追问

  • 条件分支与版本路由关系?版本路由更适合用端点路由;管道分支用于横切处理差异。
  • 分支能共享主管道已注册的中间件吗?已执行的外层中间件生效,分支内重新注册自己的链。

06.3.1.1-017 中间件依赖如何注入(委托参数)?

一句话结论

约定式中间件:构造函数取单例依赖,InvokeAsync 参数取每请求 Scoped/Transient 依赖;内联中间件可通过 context.RequestServices 解析请求作用域服务。

概念解释

  • 构造函数:应用构建中间件实例时解析,生命周期与中间件一致。
  • Invoke 参数:每请求从请求作用域解析。
  • 内联:没有构造阶段,直接从 HttpContext.RequestServices 获取。

常见误区

  • 在构造函数注入 Scoped:捕获依赖(见 06.3.1.1-010)。
  • 内联中间件用根容器解析服务:绕过请求作用域。

追问

  • 中间件需要配置选项怎么办?构造函数取 IOptions<T>(单例包装),或 Invoke 取 IOptionsMonitor<T>。
  • 服务定位器在中间件可接受吗?薄解析可以;业务服务应优先显式注入到下游层。

06.3.1.1-018 管道中如何修改请求/响应?

一句话结论

请求可改路径、头、查询、读取/缓冲请求体;响应可改状态码、头、写入内容;注意修改时机:请求在进入下游前,响应在 next() 之后。

概念解释

  • 请求:context.Request.Path、Headers、查询;请求体需启用缓冲才能重复读。
  • 响应:context.Response.StatusCode、Headers、Body 流;头必须在响应体写入前设置。

示例

context.Request.EnableBuffering();
// 读请求体,再把流位置重置
app.Use(async (ctx, next) =>
{
    await next();
    ctx.Response.Headers["X-Request-Id"] = traceId;
});

常见误区

  • 响应已开始发送后再改状态码/头:抛出异常。
  • 请求体读完不重置位置:下游读到空流。

追问

  • 响应体如何缓存/改写?包装响应流或使用结果过滤器;中间件层改写需注意缓冲。
  • 修改请求头转发给下游?在认证/代理中间件层处理,注意可信任来源。

06.3.1.1-019 WebApplication 与传统 Startup 写法?

一句话结论

.NET 6 起推荐顶部语句 + WebApplication 一站式构建服务与管道;传统 Startup 类用 ConfigureServices/Configure 两个方法,两者机制相同,只是组织方式不同。

概念解释

  • WebApplication.CreateBuilder(args):先 builder.Services 注册服务,再 Build(),最后 app 注册管道。
  • 传统:Startup.ConfigureServices 注册 DI,Configure 写管道。
  • 新写法把启动代码集中在 Program.cs,适合中小型应用;大型团队仍可用 Startup 类拆分。

示例

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
var app = builder.Build();
app.UseRouting();
app.MapControllers();
app.Run();

常见误区

  • 在 Build() 之后再往 builder.Services 加服务:容器已定型,无效。
  • 混淆两种写法的顺序:服务注册必须在 Build() 前。

追问

  • WebApplication 还能支持 Startup 类吗?可以通过 UseStartup 兼容旧式。
  • 管道注册必须在 Run() 前吗?是;Run 启动主机阻塞执行。

06.3.1.1-020 中间件短路对下游的影响?

一句话结论

短路后下游中间件、过滤器与端点都不会执行;因此限流、认证、异常处理等短路要明确职责,未执行的下游不会补做日志、审计或授权。

概念解释

  • 短路位置决定保护范围:认证短路在授权之前,则被拒请求不进入端点。
  • 外层短路产生的响应不会经过内层日志中间件,需在外层自行观测。
  • 条件短路(健康检查、CORS 预检)应只针对明确场景。

常见误区

  • 以为短路响应仍会走到端点日志:不会。
  • 在通用中间件里随意短路:破坏后续横切能力。

追问

  • 短路后如何保证审计?短路层自行写审计/指标。
  • 404 由谁产生?端点未匹配时终端中间件返回 404;可自定义 404 处理。

本节自检

  • [ ] 能画出洋葱模型并标出异常、路由、认证、授权、端点的位置
  • [ ] 能编写约定式中间件并说明构造函数与 Invoke 的注入区别
  • [ ] 能解释管道顺序错误导致的鉴权/异常问题
  • [ ] 能区分中间件与过滤器的层级与可访问对象
  • [ ] 能说明 WebApplication 服务注册与管道注册的先后约束