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/端点执行 → 结果序列化 → 响应逆序穿过管道返回。
原理流程
- Kestrel 接收连接,构造
HttpContext。 - 管道中间件依次处理(异常、日志、CORS、路由、认证、授权)。
- 路由选出端点;MVC/端点层绑定模型、校验、执行过滤器与 Action。
- Action 返回结果,格式化写响应。
- 响应逆序经过剩余中间件,返回客户端。
图示
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 服务注册与管道注册的先后约束