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

06.3.1.3 路由、模型绑定、过滤器与 Minimal API

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

本节要解决的问题

  • 路由如何匹配端点,模型绑定从哪些来源取参数?
  • MVC 过滤器有哪些类型、执行顺序如何?
  • Minimal API 与 Controller 如何取舍,端点过滤器怎么用?

版本前提:.NET 8 / ASP.NET Core 8。

06.3.1.3-001 路由系统:约定路由与属性路由?

一句话结论

ASP.NET Core 路由把 URL 映射到端点;属性路由([Route]/[HttpGet])在控制器/动作上标注模板,约定路由按 {controller}/{action}/{id} 全局模板约定;现代应用以属性路由为主。

概念解释

  • 端点路由:UseRouting 匹配候选端点,UseEndpoints/Map* 执行。
  • 属性路由:每个动作显式模板,路径清晰,适合 REST 资源。
  • 约定路由:全局模板推导控制器与动作名,适合老式 MVC。

示例

[ApiController]
[Route("api/orders")]
public class OrdersController : ControllerBase
{
    [HttpGet("{id:int}")]
    public IActionResult Get(int id) => Ok();
}

常见误区

  • 控制器不加 [Route] 又没配约定路由:端点无法匹配。
  • 属性路由模板前导斜杠与前缀拼接规则记错:控制器前缀与动作模板按规则组合。

追问

  • 路由与中间件 Map 的区别?路由在端点层匹配具体处理器;Map 是管道分支。
  • 区域(Area)如何参与路由?[Area] + 路由模板 {area:exists} 约定。

06.3.1.3-002 路由模板参数与约束?

一句话结论

模板用 {参数名} 占位,约束(:int、:guid、:min(1)、正则等)限定匹配范围;未满足约束的 URL 不匹配该端点,可配置可选参数与默认值。

概念解释

  • 参数:{id},绑定到动作参数。
  • 约束:类型、范围、正则、复合约束;约束失败返回 404(不匹配)而非 400。
  • 可选:{id?};默认值:{id=100}。

示例

app.MapGet("/orders/{id:int:min(1)}", (int id) => Results.Ok());
app.MapGet("/files/{name}.{ext?}", (string name, string? ext) => ...);

常见误区

  • 把约束当参数校验:约束只决定路由匹配,业务取值校验仍在动作内。
  • 正则约束写得过宽/过窄:匹配不到或误入非法值。

追问

  • 自定义约束怎么实现?IRouteConstraint 并在路由配置中注册。
  • 约束区分大小写吗?默认路由匹配不区分大小写,可按配置调整。

06.3.1.3-003 Model Binding 绑定来源?

一句话结论

模型绑定从路由值、查询字符串、表单、请求体、头/依赖注入等来源把输入映射到动作参数;[FromRoute]、[FromQuery]、[FromBody]、[FromForm]、[FromHeader]、[FromServices] 显式指定来源。

概念解释

  • 简单类型(int/string)默认从路由/查询绑定。
  • 复杂对象默认从请求体(ApiController 特性)或表单绑定。
  • [FromServices] 从 DI 取服务,不是用户输入。
  • 绑定后 ModelState 记录是否成功与错误。

示例

public IActionResult Get(
    [FromRoute] int id,
    [FromQuery] string? status,
    [FromBody] CreateOrderRequest req,
    [FromServices] IOrderService service) { }

常见误区

  • 复杂对象在 GET 上期望 FromBody:GET body 不可靠,应拆查询参数。
  • 混淆 [FromServices] 与输入参数:服务由容器注入,不参与模型校验。

追问

  • 绑定来源优先级冲突时?显式特性优先;未标注按类型与 ApiController 规则推断。
  • 集合/数组怎么绑定?查询参数重复键或逗号分隔,按模型绑定规则转换。

06.3.1.3-004 模型验证与 DataAnnotations?

一句话结论

参数绑定后执行模型验证:DataAnnotations 特性([Required]、[Range]、[EmailAddress]、正则)标记规则,ModelState.IsValid 汇总结果;ApiController 自动把无效模型转为 400 响应。

概念解释

  • 特性标注在 DTO 属性上;验证器递归校验复杂对象与集合。
  • 无效时 ModelStateDictionary 收集字段错误。
  • ApiController 默认自动 400,也可自定义响应。

示例

public class CreateOrderRequest
{
    [Required] public string? ItemName { get; set; }
    [Range(1, 100000)] public int Quantity { get; set; }
}
// ApiController: ModelState 无效 → 自动 ProblemDetails 400

常见误区

  • 只在动作内手写判断,DTO 上无规则:错误分散且不自动汇总。
  • 依赖特性覆盖业务规则:跨字段、状态归属仍在服务层校验。

追问

  • 自定义验证特性怎么写?实现 ValidationAttribute 重写 IsValid。
  • 关闭自动 400 怎么做?InvalidModelStateResponseFactory 自定义或禁用 ApiController 行为。

06.3.1.3-005 过滤器类型:Authorization/Resource/Action/Exception/Result?

一句话结论

MVC 过滤器分五类:授权、资源、动作(入参执行前后)、异常、结果(结果生成前后);在不同管线阶段介入,比中间件更靠近动作,能访问模型与 Action 参数。

概念解释

  • 授权过滤器:最早,判断权限。
  • 资源过滤器:授权后、动作执行前后,可短路。
  • 动作过滤器:动作方法执行前后,访问参数与结果。
  • 异常过滤器:捕获动作管线内未处理异常。
  • 结果过滤器:在 IActionResult 执行前后介入。

常见误区

  • 把跨全局请求的逻辑写成过滤器:非 MVC 端点不走过滤器。
  • 异常过滤器能捕获中间件异常吗?不能,它只管 MVC 动作管线内异常。

追问

  • 过滤器与端点过滤器关系?Minimal API 用端点过滤器,阶段语义对应但不依赖 MVC。
  • 全局过滤器与控制器/动作级如何叠加?全局先注册,特性级更具体,可覆盖顺序。

06.3.1.3-006 过滤器执行顺序与生命周期?

一句话结论

同一阶段多个过滤器按注册/顺序排列:进入阶段正序执行,离开阶段逆序执行;不同阶段按 授权→资源→动作→结果 排列,异常过滤器在异常发生时介入。

概念解释

  • 进入管线:授权 → 资源 → 动作前置 → 动作 → 动作后置 → 结果前置 → 结果执行 → 结果后置。
  • 逆序返回:后置过滤器按注册反序执行。
  • 顺序可用 IOrderedFilter.Order 控制。

图示

Authorization → Resource → Action(前置→动作→后置) → Result(前置→执行→后置)
异常过滤器:动作管线抛异常时接管

常见误区

  • 以为动作过滤器一定在资源过滤器后:阶段固定,注册顺序只影响同层。
  • 后置过滤器不执行:动作短路抛异常时对应后置不经过。

追问

  • 过滤器实例生命周期?全局/特性过滤器按管线激活,可通过 DI 解析依赖。
  • 短路在哪个过滤器可行?资源/动作过滤器可直接写结果,跳过后续阶段。

06.3.1.3-007 依赖注入进过滤器的方式?

一句话结论

过滤器可从 DI 解析依赖:全局过滤器在服务注册时加入容器;特性过滤器通过 ServiceFilter/TypeFilter 包装解析,支持构造注入;直接在特性类里构造不能走容器。

概念解释

  • ServiceFilter:从已有注册的过滤器类型解析。
  • TypeFilter:运行时创建并注入依赖。
  • 过滤器自身需要 Scoped 服务时,走过滤器工厂解析,不在特性字段持有。

示例

services.AddScoped<MyActionFilter>();
[ServiceFilter(typeof(MyActionFilter))]
public IActionResult Submit() { }

常见误区

  • 在特性类字段里 new 依赖:绕过 DI,无法替换与释放。
  • 过滤器构造函数持有 Scoped:注意生命周期(同捕获依赖规则)。

追问

  • 全局过滤器注册在哪?services.AddMvc(o => o.Filters.Add<MyFilter>())。
  • 过滤器能取当前请求服务吗?管线执行时在请求作用域内解析。

06.3.1.3-008 Minimal API 与 Controller 怎么选?

一句话结论

Minimal API 轻量、样板少、启动快,适合小服务、边缘接口、CRUD 原型;Controller 适合复杂模型绑定、过滤器体系、团队规范与大型 API;两者可在同一应用共存。

对比

维度 Minimal API Controller
样板代码 极少(委托直接映射) 控制器类 + 动作
框架能力 端点过滤器、绑定、OpenAPI 完整过滤器、模型绑定、区域
适用 微服务、简单接口 复杂业务 API、团队约定
可测试性 委托/服务注入 控制器类可独立实例化测试

常见误区

  • 认为 Minimal API 只能写 Hello World:.NET 8 已支持过滤器、分组、验证、OpenAPI。
  • 大业务接口硬塞 Minimal API:组织与复用不如控制器清晰。

追问

  • 混用怎么组织?按模块划分:简单只读接口用 Minimal,复杂写业务用 Controller。
  • Minimal API 依赖注入怎么取?委托参数直接声明服务类型,由容器注入。

06.3.1.3-009 Minimal API 参数绑定要点?

一句话结论

委托参数按类型推断绑定:简单类型从路由/查询,复杂类型从 body;可用 [FromRoute] 等显式标注;服务类型从 DI 解析;绑定失败与验证结果通过 HttpRequest/自定义校验处理。

概念解释

  • 参数名与路由参数匹配;复杂对象默认 JSON body。
  • ILogger、CancellationToken、HttpContext 等框架特殊类型可直接声明。
  • 验证:手动检查、端点过滤器或绑定库扩展。

示例

app.MapPost("/orders", async (CreateOrderRequest req, IOrderService svc, CancellationToken ct) =>
{
    if (!ModelState.IsValid) return Results.BadRequest();
    var id = await svc.CreateAsync(req, ct);
    return Results.Created($"/orders/{id}", id);
});

常见误区

  • 复杂参数从查询绑定:Minimal 约定走 body,需显式 [FromQuery]。
  • 忘记传 CancellationToken:下游无法响应请求取消。

追问

  • 可选查询参数怎么声明?可空类型 + 默认值。
  • 绑定枚举/自定义类型?实现绑定器或可转换类型,必要时自定义 BindAsync。

06.3.1.3-010 端点过滤器与 MVC 过滤器区别?

一句话结论

端点过滤器(endpoint filter)是 Minimal API 管线中的过滤器,围绕端点委托执行(前/后/异常),可访问端点与参数;MVC 过滤器属于控制器管线的五类体系;两者阶段相似但宿主不同。

概念解释

  • 端点过滤器实现 IEndpointFilter,InvokeAsync 调用 next 委托进入端点。
  • 可在过滤器中做鉴权、日志、验证、结果改写。
  • 不依赖控制器存在,Minimal API 端点也能用。

示例

public class LoggingFilter : IEndpointFilter
{
    public async ValueTask<object?> InvokeAsync(EndpointFilterInvocationContext ctx, EndpointFilterDelegate next)
    {
        var result = await next(ctx);
        return result;
    }
}
app.MapGet("/x", () => "ok").AddFilter<LoggingFilter>();

常见误区

  • 把 MVC 特性过滤器直接套到 Minimal 端点:类型体系不同。
  • 端点过滤器里访问 Controller 专属模型状态:不存在该对象。

追问

  • 端点过滤器能短路吗?能:不调用 next,直接返回结果。
  • 全局端点过滤器怎么注册?在路由分组或应用级别统一添加。

06.3.1.3-011 ProblemDetails 统一错误?

一句话结论

ProblemDetails 是 RFC 7807 风格的结构化错误对象(title、status、detail、instance、扩展字段);ASP.NET Core 内置生成,统一错误响应格式,客户端按 status/type 处理。

概念解释

  • 控制器用 Problem()/ValidationProblem();Minimal 用 Results.Problem()。
  • 开发环境可带详细信息,生产收敛。
  • 与全局异常处理器配合:异常映射为 ProblemDetails。

示例

return Problem(
    title: "订单不存在",
    statusCode: StatusCodes.Status404NotFound,
    detail: $"Order {id} not found");

常见误区

  • 错误响应各接口自定义字段:客户端无法统一解析。
  • ProblemDetails 里塞堆栈/SQL:泄露内部细节。

追问

  • 验证错误用哪个?ValidationProblem 带错误字典,对应 400/422。
  • 全局配置 ProblemDetails 选项?AddProblemDetails 自定义类型与扩展字段。

06.3.1.3-012 内容协商与 OutputFormatter?

一句话结论

内容协商根据 Accept 头选择输出格式化器:默认 JSON,可配置 XML/自定义格式化器;动作返回对象由选中的 formatter 序列化为响应体。

概念解释

  • OutputFormatter 处理响应写入;输入对应 InputFormatter 解析 body。
  • ApiController/Minimal 默认 System.Text.Json。
  • 可注册自定义 formatter 处理特殊媒体类型。

常见误区

  • 以为返回字符串就按文本写:仍走协商,按内容类型决定。
  • 自定义 formatter 未注册:响应被默认 JSON 包装。

追问

  • 二进制/文件结果用什么?FileResult/Results.File,不走对象序列化。
  • JSON 大小写/配置在哪?AddJsonOptions 配置序列化约定与转换器。

06.3.1.3-013 自定义模型绑定器场景?

一句话结论

内置绑定不满足时实现 IModelBinder(或 Minimal 的 BindAsync),从路由/查询/头/复杂来源组装参数;适合特殊类型、多来源组合、自定义转换与校验。

概念解释

  • 控制器:IModelBinder + ModelBinderProvider 注册。
  • Minimal API:参数类型实现 IBindableFromHttpContext<TSelf> 静态绑定方法。
  • 绑定器负责取值、转换、写入模型状态错误。

常见误区

  • 在动作开头手写解析多来源参数:重复且绕过 ModelState 汇总。
  • 绑定器抛异常:应记录到 ModelState,避免变成 500。

追问

  • 绑定器与验证器分工?绑定负责取值转换,验证负责规则检查。
  • 复杂 DTO 绑定失败如何提示?字段路径加入 ModelState,统一 400 响应。

06.3.1.3-014 路由冲突与消歧?

一句话结论

多个端点匹配同一 URL 时,路由按模板优先级(段约束、字面量、参数)选择;优先级相同且无法消歧时抛匹配歧义异常;调试时看端点匹配与约束条件。

概念解释

  • 字面量段优先于参数段;约束更具体的模板优先级高。
  • 冲突:两个模板都能匹配且优先级并列,请求触发 AmbiguousMatchException。
  • 排查:检查控制器路由前缀、动作模板、重复注册的 Map。

常见误区

  • 忽略歧义异常:生产偶发 500。
  • 用宽泛参数模板抢匹配:挤掉更具体的端点。

追问

  • 如何显式指定优先级?路由顺序/约束特性,或调整模板字面量。
  • 同名动作不同 HTTP 方法冲突?按方法区分,[HttpGet]/[HttpPost] 各自匹配。

06.3.1.3-015 区域(Area)与组织路由?

一句话结论

区域把控制器按功能模块分组(如 Admin/Api),通过 [Area] 特性与路由模板中的 {area} 段参与匹配;大型应用用区域、路由分组或命名空间组织模块。

概念解释

  • 区域特性标注控制器所属区域。
  • 约定路由含 {area:exists} 段;属性路由可显式写区域前缀。
  • Minimal API 用 MapGroup 统一前缀与过滤器。

示例

[Area("Admin")]
[Route("admin/[controller]")]
public class UsersController : ControllerBase { }

// Minimal 分组
var admin = app.MapGroup("/admin").RequireAuthorization();
admin.MapGet("/users", () => ...);

常见误区

  • 标了 Area 但路由模板不含 area 段:匹配不到。
  • 分组过滤器只加在部分端点:组内其余端点遗漏鉴权。

追问

  • 区域与命名空间关系?区域是路由组织概念,不强制对应程序集目录。
  • 多模块路由冲突怎么避免?模块前缀固定,分组统一管理。

06.3.1.3-016 路由值、环境变量与拦截?

一句话结论

路由值存在 RouteData,可在中间件/过滤器读取;拦截可在管道(认证、限流)或过滤器(授权、资源)层做;路由确定前管道只能访问原始请求,路由确定后才能读端点元数据。

概念解释

  • RouteData.Values:当前匹配的路由参数。
  • 端点元数据:Endpoint 上的特性(权限、约束、文档说明)。
  • 拦截位置:需要端点元数据的拦截放在 UseRouting 之后。

常见误区

  • 在 UseRouting 之前读路由值:尚未匹配,为空。
  • 用管道中间件读 [Authorize] 元数据:需先路由匹配。

追问

  • 如何在端点上挂自定义元数据?特性实现 IEndpointMetadataProvider 或在 Map 时扩展。
  • 拦截后如何跳转到错误页?写结果或重定向,注意不要再走被拦截端点。

06.3.1.3-017 Action 方法返回值与 IActionResult?

一句话结论

动作可返回实体对象(自动序列化)或 IActionResult(显式控制状态码、响应体、头);ControllerBase 提供 Ok/NotFound/BadRequest/Created/File 等助手方法。

概念解释

  • 返回对象:走内容协商序列化。
  • 返回 IActionResult:结果过滤器与 formatter 仍参与;可精确控制响应。
  • Minimal API 用 Results/TypedResults 返回等效结果对象。

示例

[HttpGet("{id}")]
public async Task<IActionResult> Get(int id, CancellationToken ct)
{
    var order = await svc.GetAsync(id, ct);
    return order is null ? NotFound() : Ok(order);
}

常见误区

  • 返回 object 却依赖特定状态码:不显式时默认 200。
  • 在动作里直接操作 Response 流:绕过结果管线与格式化。

追问

  • 异步动作返回类型?Task<IActionResult>/Task<T>;同步动作可返回 IActionResult。
  • TypedResults 有什么好处?强类型结果,便于 OpenAPI 与编译检查。

06.3.1.3-018 异步 Action 的返回类型?

一句话结论

异步动作返回 Task 或 Task<TResult>(控制器)/Task<Results<...>>(Minimal);框架等待任务完成后序列化结果;不要返回未 await 的裸任务或阻塞 .Result。

概念解释

  • 返回 Task<IActionResult>:框架异步等待,不占用线程阻塞。
  • CancellationToken 传入下游,请求取消时联动终止。
  • 异常由管线捕获,转错误响应。

常见误区

  • 动作内 fire-and-forget:任务脱离请求,结果与异常无法观测。
  • 异步方法套 .Result/.Wait():线程阻塞与死锁风险。

追问

  • 返回 ValueTask 可以吗?框架支持 Task 为主;避免在动作上用 ValueTask 复用场景。
  • 长耗时异步接口怎么处理?转异步任务模式(202 + 轮询/回调),不要同步挂请求线程。

06.3.1.3-019 模型绑定失败时如何处理?

一句话结论

绑定失败记入 ModelState;ApiController 自动转 400,非 ApiController 需在动作/过滤器检查 ModelState.IsValid;字段错误聚合到响应,不要把绑定异常漏成 500。

概念解释

  • 类型转换失败、必填缺失、验证不过都进 ModelState。
  • 自动 400 响应含字段错误字典。
  • 自定义处理:替换 InvalidModelStateResponseFactory。

示例

if (!ModelState.IsValid)
    return ValidationProblem(ModelState);

常见误区

  • 不检查 ModelState 直接继续执行:非法值进入业务层。
  • 绑定失败抛未捕获异常:应为 400/422 而非 500。

追问

  • 嵌套对象绑定错误路径怎么展示?模型状态键含属性层级,响应按路径定位字段。
  • 自定义校验补充进 ModelState?ModelState.AddModelError。

06.3.1.3-020 特性路由上的权限标注与路由约束配合?

一句话结论

[Authorize] 等元数据挂在控制器/动作/端点上,路由匹配后授权管线读取这些元数据做判断;路由约束只决定能否匹配端点,不做权限判断,两者各司其职。

概念解释

  • 路由约束:URL 形态匹配。
  • 授权元数据:身份与策略要求,由授权中间件/过滤器读取。
  • 未匹配约束 → 404;匹配但未授权 → 401/403。

示例

[Authorize(Roles = "admin")]
[HttpGet("{id:int}")]
public IActionResult AdminDetail(int id) { }

常见误区

  • 用路由段隐藏管理接口代替鉴权:路径可被猜到,权限仍需服务端判断。
  • 授权元数据挂在管道错误位置:授权中间件读不到端点元数据。

追问

  • 策略授权与角色授权怎么组合?[Authorize(Policy = "order:read")],策略内可组合角色/声明要求。
  • 匿名端点怎么标注?[AllowAnonymous] 覆盖类级授权。

本节自检

  • [ ] 能写出属性路由模板并使用路由约束
  • [ ] 能判断参数绑定来源并显式标注 FromXxx
  • [ ] 能说出五类过滤器与执行阶段、顺序规则
  • [ ] 能按场景在 Minimal API 与 Controller 间取舍
  • [ ] 能区分路由约束、授权元数据与模型校验的职责边界