ASP.NET中Filter的定义、过滤对象及使用形式咨询

1. 该语境下的“Filter”指什么？ #

在ASP.NET（包括Core）生态里，Filter是一组可以灵活插入到请求处理流程的组件，相当于请求管道里的“拦截节点”。它的核心作用是处理那些横跨多个业务模块的通用逻辑——比如权限校验、日志记录、异常捕获、请求参数校验这些，不用在每个Controller或Action里重复写代码。
你提到的ActionFilter、AuthorizationFilterAttribute属于ASP.NET MVC/Core的原生过滤器体系，而IAuthorizationFilter、IOperationFilter是Swagger扩展里的过滤器，本质都是遵循“拦截-处理-传递”逻辑的组件，只是作用场景（原生请求管道 vs Swagger文档生成）不一样。

2. 它过滤的是什么实体？ #

别被“过滤”的字面意思局限，不同类型的过滤器，处理的目标和阶段完全不同：

• ASP.NET原生请求过滤器：主要针对HTTP请求/响应的生命周期流程或数据：
  • 授权过滤器（AuthorizationFilter）：“过滤”的是请求的访问权限——判断当前请求是否能进入后续处理流程，不符合的直接拦截返回；
  • 动作过滤器（ActionFilter）：“过滤”的是Action方法的输入（请求参数）和输出（ActionResult），可以在方法执行前后修改参数、包装结果；
  • 异常过滤器（ExceptionFilter）：“过滤”的是请求处理中抛出的异常，捕获后统一处理（比如返回友好错误信息、记录日志）；
• Swagger相关过滤器：针对的是Swagger文档的元数据：
  • IOperationFilter用来过滤或修改Swagger里API操作的元数据（比如给接口加自定义参数、调整接口描述）；
  • Swagger的IAuthorizationFilter则是控制哪些接口能出现在生成的Swagger文档中。

说白了，“过滤”在这里更偏向于拦截、校验、修改或补充目标对象，而非单纯的“筛选删除”。

3. 过滤器是否始终以属性形式使用？ #

当然不是。属性（Attribute）只是最常用的局部注册方式（比如给Controller/Action打[Authorize]、[ActionFilter]标签），还有两种很常见的使用方式：

• 全局注册：在Program.cs（或旧版的Startup.cs）里把过滤器注册到全局管道，对所有请求生效。比如ASP.NET Core中的写法：

  builder.Services.AddControllers(options =>
  {
      options.Filters.Add<GlobalExceptionFilter>(); // 注册全局异常过滤器
  });
  

• 依赖注入式注册：如果过滤器需要用到其他服务（比如日志服务），可以通过DI容器注入，配合ServiceFilter或TypeFilter属性使用，或者全局注册时指定服务类型。示例：

  [ServiceFilter(typeof(CustomAuthorizationFilter))]
  public IActionResult Index()
  {
      return View();
  }
  

另外，Swagger的过滤器基本都是在配置Swagger生成器时注册，完全不用属性：

builder.Services.AddSwaggerGen(c =>
{
    c.OperationFilter<CustomOperationFilter>(); // 注册Swagger操作过滤器
});

内容的提问来源于stack exchange，提问作者Prajval Gahine