09.6 阶段 5:ASP.NET Core 框架主线
所属:全栈开发面试题库 / 学习路径 / 09 C# 与 .NET 全栈
本页目录
一、阶段定位
前四个阶段解决"语言、运行时、工程化"。本阶段开始写真正的 Web API。重点是 ASP.NET Core 的三根主线:
- 请求管道:Host 启动、中间件按注册顺序串成管道、短路与终端中间件——这是"一个请求进来经过了什么"。
- 依赖注入:DI 容器、三种生命周期(Singleton/Scoped/Transient)、作用域陷阱——这是"服务从哪来、活多久"。
- 配置与模型:配置源优先级、Options 模式绑定强类型配置、Minimal API 与 Controller 的取舍、模型绑定与验证——这是"参数怎么进来、配置怎么读"。
本阶段与前后阶段的衔接:往上承接阶段 4 的工程骨架,本阶段把 Web API 项目放进这个骨架;往下接 阶段 6 数据层、认证与通信,那时在这个管道里加 EF Core、JWT、gRPC。跳过中间件顺序与 DI 生命周期,后面"鉴权失效""Scoped 被 Singleton 持有导致并发错"会反复出现。
原有卡点的可判断现象依据:
- 中间件顺序写反导致鉴权失效:判断标准是——把鉴权中间件放在静态文件或路由之后,匿名请求照样能访问受保护接口,因为请求根本没经过鉴权这一步。
- Singleton 注入 Scoped 造成作用域泄漏:判断标准是——启动就抛
InvalidOperationException: Cannot consume scoped service ... from singleton,或运行时出现数据串请求(因为单例持有了本该请求级的对象)。 - 配置直接读静态值不用 Options:判断标准是——用
IConfiguration["Key"]到处读字符串,没有强类型绑定,改配置后不知道哪处没生效。 - Minimal API 与 Controller 边界判断不清:判断标准是——简单接口也硬上 Controller(一堆类),或复杂业务还在 Minimal API 里堆 lambda 难以维护。
二、阶段目标与投入
学完本页,应当能用可观察的行为证明以下六条能力:
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 能画出请求从进入到响应经过的中间件链 | 口述每个中间件的位置与作用 |
| 能说明 DI 三种生命周期的差异 | 说出服务在一次请求中被创建几次 |
| 能解释 Singleton 持有 Scoped 的后果 | 复现"Cannot consume scoped service"异常 |
| 能用 Options 模式绑定强类型配置 | IOptions<TOptions> 注入并读取 |
| 能写出带模型验证的 Minimal API | 校验失败返回 400 |
| 能配置异常处理中间件与健康检查 | 异常被捕获返回统一错误格式 |
建议学时:
- 全职(每天有效学习 4–6 小时):2 周,约 65 小时。
- 在职(每天 2 小时、周末补 4 小时):6 周。
学时分配建议:Host 与启动 10%、中间件管道 20%、DI 生命周期与作用域陷阱 20%、配置与 Options 20%、Minimal API 与模型绑定 20%、异常处理/限流/健康检查 10%。DI 与中间件顺序是面试与线上问题的重灾区。
三、先修自检
进入本阶段前逐条自检;任何一条做不到,先回到对应页面补齐。
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| C# 语言 | 会写类、接口、异步 | 09.2 阶段 1 |
| async/await | 能写异步方法 | 09.3 阶段 2 |
| 工程骨架 | 有 src/ + tests/ 结构 | 09.5 阶段 4 |
| HTTP 基础 | 认识状态码与请求方法 | 09.1 阶段 0 |
四、知识地图
"掌握程度"分三档:了解、会用、能讲清原理。
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| Host 与启动 | WebApplication.CreateBuilder、服务注册与中间件顺序 |
能讲清原理 | 06.3 .NET 后端 |
| 中间件管道 | 顺序、前置后置、短路、终端中间件 Run/Map |
能讲清原理 | 06.3 .NET 后端 |
| DI 生命周期 | Singleton/Scoped/Transient、作用域陷阱、IHostedService |
能讲清原理 | 06.3 .NET 后端 |
| 配置与 Options | 配置源优先级、IOptions/IOptionsSnapshot/IOptionsMonitor |
会用 | 06.3 .NET 后端 |
| Minimal API 与绑定 | Minimal API vs Controller、路由、模型绑定与验证 | 会用 | 06.3 .NET 后端 |
| 异常与限流 | 异常处理中间件、限流、健康检查 | 会用 | 06.3 .NET 后端 |
进度管理建议:把这张表复制到笔记里,三档都到位再进 阶段 6。《知识点全清单》是更细的全量清单。
五、分模块精讲
5.1 Host 与启动模型
为什么需要它:ASP.NET Core 的一切(服务、中间件、配置)都挂在 Host 上。不理解启动顺序,就不知道"为什么服务注册早于中间件"。
核心机制:
WebApplication.CreateBuilder(args)创建 Host 构建器,自带配置(环境变量、appsettings.json)。builder.Services.Add...注册服务(DI 容器)。builder.Build()构建 Host。app.Map...注册中间件与端点。app.Run()启动监听。- 启动顺序:先注册服务(Services),再 Build,再注册中间件(app),最后 Run。
最小可运行示例:
var builder = WebApplication.CreateBuilder(args);
// 1. 注册服务到 DI 容器
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
var app = builder.Build();
// 2. 注册中间件(顺序很重要)
if (app.Environment.IsDevelopment())
{
app.UseSwagger();
app.UseSwaggerUI();
}
// 3. 端点
app.MapGet("/hello", () => new { Message = "hi" });
app.Run();
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 服务没注册成功 | 在 Build 之后才 Add 服务 | 所有 Services.Add 在 Build() 之前 |
| 中间件顺序错 | app 注册顺序不对 | 按官方文档顺序:异常→路由→鉴权→端点 |
面试考法:常见问法是"ASP.NET Core 的启动流程"。要答出:CreateBuilder 建构建器→注册服务→Build→注册中间件→Run。
5.2 中间件管道:顺序、短路与终端
为什么需要它:一个请求从进来到响应,依次经过所有注册的中间件。顺序错了,鉴权、日志、异常处理全都失效。
核心机制:
- 中间件按
app.Use...的注册顺序串成管道,请求先过前面的中间件,响应再从后往回走。 - 前置/后置:
Use里next()之前是前置(请求到达时),之后是后置(响应返回时)。 - 短路:某个中间件直接写响应不调
next(),后面的中间件不再执行。 - 终端中间件:
app.Run(...)或app.MapGet(...)是管道的终点,不调用 next。 - 官方推荐顺序:异常处理→HSTS→HTTPS 重定向→路由→鉴权→用户→端点。
最小可运行示例:
// 自定义中间件:前置记录开始,后置记录耗时
app.Use(async (context, next) =>
{
var sw = System.Diagnostics.Stopwatch.StartNew();
Console.WriteLine($"请求进入: {context.Request.Path}"); // 前置
await next(); // 交给下一个中间件
Console.WriteLine($"请求返回: {sw.ElapsedMilliseconds}ms"); // 后置
});
// 终端中间件:直接响应,不再 next
app.MapGet("/hello", () => "hi");
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 鉴权失效 | 鉴权中间件在路由之后 | 把 UseAuthentication 放到 UseRouting 之后、端点之前 |
| 异常处理没捕获 | 异常中间件放在管道最末 | 异常处理放管道最前面 |
| 静态文件在鉴权前暴露 | UseStaticFiles 在鉴权前 |
鉴权先于静态文件 |
面试考法:高频题是"中间件顺序为什么重要""什么是短路"。要答出:请求按注册顺序经过中间件,顺序错会让鉴权/日志失效;短路指中间件直接响应不调 next,后续不再执行。
5.3 DI 生命周期与作用域陷阱
为什么需要它:ASP.NET Core 自带 DI 容器。服务注册成 Singleton、Scoped 还是 Transient,直接决定它活多久、会不会被并发污染。
核心机制:
- Singleton:整个应用生命周期一个实例,所有请求共享。
- Scoped:每个请求一个实例,请求结束释放。
- Transient:每次解析都新建。
- 作用域陷阱:Singleton 不能持有 Scoped 服务——因为单例活得比请求长,它会把本该请求级的对象一直攥着,导致数据串请求。
- 容器会在启动时检测"Singleton 解析 Scoped"并抛
InvalidOperationException: Cannot consume scoped service ... from singleton。 IHostedService(后台任务)运行在单例作用域里,它要用 Scoped 服务时要手动IServiceScopeFactory.CreateScope()。
最小可运行示例:
// 注册三种生命周期
builder.Services.AddSingleton<IMySingleton, MySingleton>();
builder.Services.AddScoped<IMyScoped, MyScoped>();
builder.Services.AddTransient<IMyTransient, MyTransient>();
// 错误:Singleton 持有 Scoped
// services.AddSingleton<IMyScoped, MyScoped>(); // 会在启动报错
// IHostedService 里要用 Scoped 服务,手动建作用域
public class MyBackgroundService : BackgroundService
{
private readonly IServiceScopeFactory _scopeFactory;
public MyBackgroundService(IServiceScopeFactory scopeFactory)
=> _scopeFactory = scopeFactory;
protected override async Task ExecuteAsync(CancellationToken stoppingToken)
{
using var scope = _scopeFactory.CreateScope();
var scoped = scope.ServiceProvider.GetRequiredService<IMyScoped>();
// 使用 scoped 服务
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 启动报 "Cannot consume scoped service from singleton" | Singleton 直接注入 Scoped | Singleton 里用 IServiceScopeFactory.CreateScope() |
| 两个请求读到对方的数据 | Scoped 对象被单例长期持有 | 检查是否误把 Scoped 注册成 Singleton |
| 后台任务用 DbContext 报错 | DbContext 是 Scoped,后台是单例 | 手动建 scope 再取 DbContext |
面试考法:高频题是"三种生命周期的区别""Singleton 持有 Scoped 会怎样""IHostedService 怎么用 Scoped 服务"。要答出:Singleton 全局一份、Scoped 每请求一份、Transient 每次新建;单例持 Scoped 会导致作用域泄漏;后台任务用 IServiceScopeFactory 建独立作用域。
5.4 配置体系与 Options 模式
为什么需要它:配置分散在 appsettings.json、环境变量、命令行。直接读字符串既不类型安全,也不好测试。Options 模式把配置绑成强类型对象。
核心机制:
- 配置源优先级(后者覆盖前者):appsettings.json → appsettings.环境.json → 环境变量 → 命令行。
- Options 三种:
IOptions<T>:单例,配置在启动时读一次,不随变化刷新。IOptionsSnapshot<T>:Scoped,每个请求读一次,可感知配置变化。IOptionsMonitor<T>:单例,可监听配置变化并回调。
- 绑定:
builder.Services.Configure<T>(builder.Configuration.GetSection("Section"))。
最小可运行示例:
// appsettings.json: { "RateLimit": { "PermitLimit": 100 } }
builder.Services.Configure<RateLimitOptions>(
builder.Configuration.GetSection("RateLimit"));
// 强类型配置类
public class RateLimitOptions
{
public int PermitLimit { get; set; }
}
// 注入使用
app.MapGet("/api", (IOptions<RateLimitOptions> options) =>
$"允许 {options.Value.PermitLimit} 个请求");
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 改了配置不生效 | 用了 IOptions<T>(启动时读死) |
需要热更新用 IOptionsMonitor<T> |
| 配置值是 null | Section 名不匹配 | 检查 JSON 节点名与类属性名 |
到处 IConfiguration["Key"] 读字符串 |
没用强类型绑定 | 改成 Options 模式 |
面试考法:常见问法是"IOptions、IOptionsSnapshot、IOptionsMonitor 的区别"。要答出:Options 单例不刷新;Snapshot 每请求可刷新;Monitor 可监听变化回调。
5.5 Minimal API 与 Controller、模型绑定
为什么需要它:小型接口用 Minimal API 一个 lambda 就够,复杂业务用 Controller 分 controller/action 更清晰。选错边界会让代码难维护。
核心机制:
- Minimal API:
app.MapGet("/x", handler),轻量,适合简单接口。 - Controller:基于特性路由,适合业务复杂、需要过滤器、模型绑定丰富的场景。
- 模型绑定:从路由、查询、Body、Header 把参数映射到方法参数。
- 验证:用数据注解
[Required]、[Range],或手动[ApiController]自动 400。
最小可运行示例:
// Minimal API:带验证
app.MapPost("/orders", (CreateOrderRequest req) =>
{
if (req.Amount <= 0) return Results.BadRequest("金额必须大于 0");
return Results.Ok(new { req.Id, req.Amount });
});
public record CreateOrderRequest(string Id, decimal Amount);
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 参数为 null | 模型绑定名不匹配 | 确认参数名与路由/Body 字段一致 |
| 复杂业务堆在 Minimal API 里 | 边界选错 | 业务复杂时改用 Controller |
| 校验失败没返回 400 | 没开 [ApiController] 自动验证 |
用 [ApiController] 或手动校验 |
面试考法:常见问法是"Minimal API 和 Controller 怎么选"。要答出:简单接口用 Minimal API(少样板),复杂业务(多过滤器、模型绑定、分组)用 Controller。
5.6 异常处理、限流与健康检查
为什么需要它:生产环境必须有统一的异常处理、限流保护与健康检查(给编排系统探活)。裸奔的接口一报错就是堆栈、一压就垮。
核心机制:
- 异常处理中间件:放管道最前,捕获未处理异常,返回统一错误格式(不泄露堆栈)。
- 限流:固定窗口/令牌桶,保护后端不被打垮。
- 健康检查:
/health返回存活探针,不探测重资源(数据库、外部服务),否则会引发雪崩。
最小可运行示例:
// 异常处理:放管道最前
app.UseExceptionHandler("/error");
// 限流
builder.Services.AddRateLimiter(options =>
options.AddFixedWindowLimiter("fixed", o =>
{
o.PermitLimit = 100;
o.Window = TimeSpan.FromSeconds(1);
}));
// 健康检查
builder.Services.AddHealthChecks();
app.MapHealthChecks("/health");
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 接口返回堆栈给客户端 | 没配异常处理中间件 | 加 UseExceptionHandler,统一错误格式 |
| 健康检查拖垮数据库 | 健康检查探了数据库 | 存活探针不探重资源,就绪探针才探 |
| 压测时接口全 429 | 限流阈值设太低 | 按容量调整 PermitLimit |
面试考法:常见问法是"异常处理中间件为什么放最前面""健康检查该探什么"。要答出:放最前才能捕获后续所有中间件的异常;存活探针只探进程活着,不探数据库避免雪崩。
六、分层练习
三档练习逐档升级,上一档没做完不要跳。
6.1 复现型(照着做,目标是跑通 + 能解释)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 第一个 Minimal API | app.MapGet 返回对象 |
curl 返回 JSON |
1 小时 |
| 自定义中间件 | 记录请求耗时 | 日志显示前置/后置 | 1 小时 |
| 三种 DI 生命周期 | 分别注册,注入后看实例数 | 能说清每次请求创建几次 | 1.5 小时 |
| Options 绑定 | appsettings 绑强类型配置 | 接口返回配置值 | 1 小时 |
6.2 改造型(给出现成代码,改出正确行为)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 修复作用域陷阱 | 给定 Singleton 注入 Scoped,改成 IServiceScopeFactory |
启动不报错 | 1.5 小时 |
| 把中间件顺序改对 | 给定鉴权在路由后 | 匿名请求被拒 | 1.5 小时 |
把 IConfiguration["x"] 改成 Options |
强类型绑定 | 配置类型安全 | 1.5 小时 |
| 加异常处理中间件 | 统一错误格式 | 异常不返回堆栈 | 1 小时 |
6.3 设计型(自己定方案,目标是能交付、能讲清取舍)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 分层 Web API | Minimal API + 业务服务 + 强类型配置 | 能画出请求中间件链 | 6 小时 |
| 带限流与健康检查的接口 | 限流 + /health |
压测超阈值返回 429 | 4 小时 |
| 后台任务用 Scoped 服务 | BackgroundService 手动建 scope |
不触发作用域陷阱 | 3 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 启动报 "Cannot consume scoped service from singleton" | Singleton 直接注入 Scoped | 看 Singleton 构造函数 | 用 IServiceScopeFactory.CreateScope() |
| 匿名请求访问受保护接口 | 鉴权中间件在路由之后 | 看中间件注册顺序 | 鉴权放到路由之后、端点之前 |
| 接口返回堆栈给客户端 | 没配异常处理中间件 | 看管道最前 | 加 UseExceptionHandler |
| 改配置不生效 | 用了 IOptions<T> |
看注入的 Options 类型 | 需要热更新用 IOptionsMonitor<T> |
| 后台任务用 DbContext 报错 | DbContext 是 Scoped | 看后台是否直接注入 | 手动建 scope 再取 |
| 压测时大量 429 | 限流阈值太低 | 看限流配置 | 按容量调 PermitLimit |
| 健康检查拖垮数据库 | 存活探针探了数据库 | 看健康检查注册项 | 存活不探重资源 |
| 模型绑定参数为 null | 名字不匹配 | 核对参数名与路由/Body | 统一命名 |
八、出口条件
全部勾选后再进入 阶段 6 数据层、认证与通信。
- [ ] 能画出请求从进入到响应经过的中间件链,说明顺序为什么重要
- [ ] 能说明 DI 三种生命周期,解释 Singleton 持有 Scoped 的后果
- [ ] 能用
IServiceScopeFactory让后台任务安全使用 Scoped 服务 - [ ] 能用 Options 模式绑定强类型配置,区分三种 Options
- [ ] 能按项目复杂度选 Minimal API 或 Controller
- [ ] 能配置异常处理中间件、限流与健康检查
- [ ] 排障表里的八个现象,随机抽三个能在 5 分钟内给出排查路径
自测题(先自己想,再看要点):
- 中间件为什么要按固定顺序注册?
- 要点:请求按注册顺序经过中间件,顺序错会让鉴权/日志/异常处理失效。
- Singleton、Scoped、Transient 的区别?
- 要点:Singleton 全局一份,Scoped 每请求一份,Transient 每次解析新建。
- Singleton 持有 Scoped 会怎样?
- 要点:启动报 "Cannot consume scoped service from singleton",运行时导致作用域泄漏、数据串请求。
IOptions、IOptionsSnapshot、IOptionsMonitor的区别?- 要点:Options 单例启动时读死;Snapshot 每请求可刷新;Monitor 可监听变化回调。
- IHostedService 里要用 Scoped 服务怎么办?
- 要点:注入
IServiceScopeFactory,手动CreateScope()后再取服务。
- 要点:注入
- 异常处理中间件为什么放管道最前面?
- 要点:放最前才能捕获后续所有中间件与端点抛出的未处理异常。
- 健康检查的存活探针该探什么?
- 要点:只探进程是否活着,不探数据库等重资源,避免被探活拖垮或引发雪崩。