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 间取舍
- [ ] 能区分路由约束、授权元数据与模型校验的职责边界