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

09.6 阶段 5:ASP.NET Core 框架主线

所属:全栈开发面试题库 / 学习路径 / 09 C# 与 .NET 全栈

本页目录

一、阶段定位

前四个阶段解决"语言、运行时、工程化"。本阶段开始写真正的 Web API。重点是 ASP.NET Core 的三根主线:

  1. 请求管道:Host 启动、中间件按注册顺序串成管道、短路与终端中间件——这是"一个请求进来经过了什么"。
  2. 依赖注入:DI 容器、三种生命周期(Singleton/Scoped/Transient)、作用域陷阱——这是"服务从哪来、活多久"。
  3. 配置与模型:配置源优先级、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 分钟内给出排查路径

自测题(先自己想,再看要点):

  1. 中间件为什么要按固定顺序注册?
    • 要点:请求按注册顺序经过中间件,顺序错会让鉴权/日志/异常处理失效。
  2. Singleton、Scoped、Transient 的区别?
    • 要点:Singleton 全局一份,Scoped 每请求一份,Transient 每次解析新建。
  3. Singleton 持有 Scoped 会怎样?
    • 要点:启动报 "Cannot consume scoped service from singleton",运行时导致作用域泄漏、数据串请求。
  4. IOptions、IOptionsSnapshot、IOptionsMonitor 的区别?
    • 要点:Options 单例启动时读死;Snapshot 每请求可刷新;Monitor 可监听变化回调。
  5. IHostedService 里要用 Scoped 服务怎么办?
    • 要点:注入 IServiceScopeFactory,手动 CreateScope() 后再取服务。
  6. 异常处理中间件为什么放管道最前面?
    • 要点:放最前才能捕获后续所有中间件与端点抛出的未处理异常。
  7. 健康检查的存活探针该探什么?
    • 要点:只探进程是否活着,不探数据库等重资源,避免被探活拖垮或引发雪崩。