ASP.NET Core中的资源筛选器是什么？如何创建？

来源：这里教程网时间：2026-02-21 17:24:23 作者：

资源筛选器，简单来说，就是ASP.NET Core请求管道中的一道关卡，让你有机会在请求处理的早期介入，执行一些全局性的任务，比如缓存、授权，甚至可以短路请求直接返回响应。它比授权过滤器更早执行，比其他类型的过滤器作用域更广。

资源筛选器是ASP.NET Core中一种强大的请求处理管道组件，它允许你在请求到达控制器之前或之后执行代码。这使得资源筛选器非常适合处理横切关注点，例如缓存、授权和日志记录。

资源筛选器与其他过滤器的区别？

资源筛选器和其他过滤器（如授权过滤器、操作过滤器、异常过滤器和结果过滤器）的主要区别在于它们的执行顺序和作用域。

执行顺序： 资源筛选器是第一个执行的过滤器，在授权过滤器之前。这意味着资源筛选器可以影响授权过程，例如通过检查缓存并短路请求。 作用域： 资源筛选器的作用域比其他过滤器更广。它们可以影响整个请求处理管道，而不仅仅是特定的控制器或操作。

简单来说，你可以把资源过滤器看作是守门员，在请求进入“核心区域”之前，先进行一轮检查和处理。

如何创建自定义资源筛选器？

创建自定义资源筛选器，主要有两种方式：实现

IResourceFilter

接口或继承

Attribute

并实现

IResourceFilter

接口。推荐使用第二种方式，可以方便地通过特性标记来应用筛选器。

1. 实现

IResourceFilter

接口：

public class MyResourceFilter : IResourceFilter
{
    private readonly ILogger<MyResourceFilter> _logger;
    public MyResourceFilter(ILogger<MyResourceFilter> logger)
    {
        _logger = logger;
    }
    public void OnResourceExecuting(ResourceExecutingContext context)
    {
        _logger.LogInformation("MyResourceFilter - OnResourceExecuting");
        // 在这里执行请求处理前的逻辑
        // 例如：检查缓存，如果存在则短路请求
    }
    public void OnResourceExecuted(ResourceExecutedContext context)
    {
        _logger.LogInformation("MyResourceFilter - OnResourceExecuted");
        // 在这里执行请求处理后的逻辑
        // 例如：更新缓存
    }
}

2. 继承

Attribute

并实现
IResourceFilter
接口（推荐）：

[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = false, Inherited = true)]
public class MyResourceFilterAttribute : Attribute, IResourceFilter
{
    private readonly ILogger<MyResourceFilterAttribute> _logger;
    public MyResourceFilterAttribute(ILogger<MyResourceFilterAttribute> logger)
    {
        _logger = logger;
    }
    public void OnResourceExecuting(ResourceExecutingContext context)
    {
        _logger.LogInformation("MyResourceFilterAttribute - OnResourceExecuting");
        // 在这里执行请求处理前的逻辑
        // 例如：检查缓存，如果存在则短路请求
        // 示例：短路请求
        // context.Result = new ContentResult { Content = "请求被资源筛选器短路！" };
    }
    public void OnResourceExecuted(ResourceExecutedContext context)
    {
        _logger.LogInformation("MyResourceFilterAttribute - OnResourceExecuted");
        // 在这里执行请求处理后的逻辑
        // 例如：更新缓存
    }
}

3. 注册筛选器：

在

Startup.cs

的

ConfigureServices

方法中注册筛选器：

public void ConfigureServices(IServiceCollection services)
{
    services.AddControllers(options =>
    {
        // 全局注册
        // options.Filters.Add(new MyResourceFilter());
    });
    // 注册Logger
    services.AddLogging();
    // 注册筛选器依赖
    services.AddScoped<MyResourceFilter>();
    services.AddScoped<MyResourceFilterAttribute>();
}

4. 应用筛选器：

全局应用： 在
ConfigureServices
中，通过
options.Filters.Add(new MyResourceFilter());
全局注册。 控制器或操作级别应用： 使用特性标记：
[MyResourceFilter]
或
[TypeFilter(typeof(MyResourceFilter))]

[ApiController]
[Route("[controller]")]
[MyResourceFilterAttribute] // 使用特性标记
public class WeatherForecastController : ControllerBase
{
    private readonly ILogger<WeatherForecastController> _logger;
    public WeatherForecastController(ILogger<WeatherForecastController> logger)
    {
        _logger = logger;
    }
    [HttpGet]
    //[TypeFilter(typeof(MyResourceFilter))] // 也可以这样使用
    public IEnumerable<WeatherForecast> Get()
    {
        return Enumerable.Range(1, 5).Select(index => new WeatherForecast
        {
            Date = DateTime.Now.AddDays(index),
            TemperatureC = Random.Shared.Next(-20, 55),
            Summary = Summaries[Random.Shared.Next(Summaries.Length)]
        })
        .ToArray();
    }
}

注意，使用

TypeFilter

可以解决构造函数注入的问题，而直接使用特性标记则需要在

ConfigureServices

中注册依赖。

资源筛选器在实际项目中的应用场景有哪些？

资源筛选器的应用场景非常广泛，以下是一些常见的例子：

缓存： 在
OnResourceExecuting
中检查缓存，如果缓存命中，则短路请求，直接返回缓存数据。在
OnResourceExecuted
中更新缓存。 授权： 虽然有专门的授权过滤器，但资源筛选器可以在更早的阶段进行一些预授权检查，例如检查用户是否已登录。 日志记录： 记录请求的开始和结束时间，以及其他相关信息。 请求验证： 对请求数据进行全局验证，例如检查请求头是否包含必要的参数。 防止CSRF攻击： 在请求处理的早期阶段验证 Anti-Forgery Token。 全局异常处理： 虽然有异常过滤器，但资源筛选器可以在更早的阶段捕获一些异常，并进行处理。

如何在资源筛选器中访问和修改请求和响应？

在

ResourceExecutingContext

和

ResourceExecutedContext

中，你可以访问和修改请求和响应。

访问请求： 通过
context.HttpContext.Request
访问请求对象。你可以读取请求头、查询字符串、请求体等信息。 修改请求： 虽然不建议直接修改请求，但在某些情况下，你可能需要修改请求头或查询字符串。 访问响应： 通过
context.HttpContext.Response
访问响应对象。 修改响应： 你可以修改响应头、状态码、响应体等信息。 短路请求： 通过设置
context.Result
来短路请求，并返回自定义的响应。

例如，以下代码演示了如何在资源筛选器中读取请求头，并设置响应头：

public void OnResourceExecuting(ResourceExecutingContext context)
{
    string userAgent = context.HttpContext.Request.Headers["User-Agent"];
    _logger.LogInformation($"User-Agent: {userAgent}");
    context.HttpContext.Response.Headers.Add("X-Custom-Header", "Hello from Resource Filter");
}