端点过滤器在路由匹配后、执行前拦截请求，通过实现EndpointFilter或使用委托，可验证、修改或阻止特定端点的请求。
端点过滤器通过在请求处理管道中插入自定义逻辑，实现对特定端点的请求拦截。它们运行在路由匹配之后，实际执行端点之前，可以用来验证、修改或阻止请求。
端点过滤器的基本作用机制
ASP.NET Core 的端点路由系统会先根据请求路径找到匹配的端点（如控制器方法或最小 API 的委托），然后在执行该端点前，检查是否有注册的过滤器需要运行。这些过滤器可以是全局的，也可以只应用于某些端点。
过滤器通过实现 EndpointFilter 接口或使用委托形式来定义逻辑。当请求命中一个带有过滤器的端点时，框架会调用过滤器方法，由你决定是否继续执行原端点。
如何定义和应用端点过滤器
你可以使用匿名函数或类来创建过滤器，并通过 [EndpointFilter] 特性或在 Map 时添加到具体端点上。
- 使用委托方式定义简单日志或权限检查逻辑
- 在 Minimal API 中调用 Handle
() 或 AddEndpointFilter() 来附加过滤器 - 在控制器中使用 [EndpointFilter(typeof(MyFilter))] 标记目标方法
拦截请求的具体操作示例
假设你想阻止没有特定头信息的请求：
builder.MapGet("/data", () => "敏感数据")
.AddEndpointFilter(async (context, next) =>
{
var header = context.HttpContext.Request.Headers["X-Access-Token"];
if (string.IsNullOrEmpty(header))
{
return Results.Unauthorized();
}
return await next(context);
});
这个过滤器会在真正执行 "/data" 处理逻辑前运行。如果缺少指定头，直接返回 401，不再进入后续处理；否则调用 next(context) 继续流程。
与中间件的区别
中间件作用于整个请求管道，影响所有请求。而端点过滤器只针对具体端点，更精确。它知道当前执行的是哪个端点，也能访问参数元数据，适合做参数校验、权限细化、日志记录等场景。
基本上就这些——端点过滤器提供了一种轻量且精准的方式，在不侵入业务代码的前提下控制请求行为。
