ASP.NET Core 中的端点过滤器如何拦截请求？-C#.Net教程-PHP中文网

ASP.NET Core 中的端点过滤器如何拦截请求？

星降

发布： 2025-10-08 14:30:01

原创

556人浏览过

端点过滤器在路由匹配后、执行前拦截请求，通过实现EndpointFilter或使用委托，可验证、修改或阻止特定端点的请求。

asp.net core 中的端点过滤器如何拦截请求？

端点过滤器通过在请求处理管道中插入自定义逻辑，实现对特定端点的请求拦截。它们运行在路由匹配之后，实际执行端点之前，可以用来验证、修改或阻止请求。

端点过滤器的基本作用机制

ASP.NET Core 的端点路由系统会先根据请求路径找到匹配的端点（如控制器方法或最小 API 的委托），然后在执行该端点前，检查是否有注册的过滤器需要运行。这些过滤器可以是全局的，也可以只应用于某些端点。

过滤器通过实现 EndpointFilter 接口或使用委托形式来定义逻辑。当请求命中一个带有过滤器的端点时，框架会调用过滤器方法，由你决定是否继续执行原端点。

如何定义和应用端点过滤器

你可以使用匿名函数或类来创建过滤器，并通过 [EndpointFilter] 特性或在 Map 时添加到具体端点上。

PatentPal专利申请写作

AI软件来为专利申请自动生成内容

查看详情

使用委托方式定义简单日志或权限检查逻辑
在 Minimal API 中调用 Handle<T>() 或 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) 继续流程。