.NET 8中如何动态设置OutputCache标签以实现单条缓存项的驱逐？

嘿，这个问题我刚好踩过坑，.NET 8的OutputCache其实已经给了足够的扩展点来实现你要的需求——给每个页面动态加专属标签，然后通过标签精准驱逐单条缓存。我给你拆解下具体怎么做：

首先核心思路是利用OutputCache策略配置里的OnCreatingEntry回调，这个回调能在缓存条目创建前拿到当前的HttpContext，这样就能动态获取当前页面的信息，把它的唯一标识（比如页面ID或者URL）作为标签加到缓存项上。

第一步：配置动态标签 #

在你的IServiceCollection扩展方法里配置OutputCache策略时，除了原来的固定配置，额外加上动态标签的逻辑：

options.AddPolicy(profile.Key, builder =>
{
    builder.Tag(profile.Key); // 保留你原来的固定标签
    builder.SetVaryByRouteValue(profile.Value?.VaryByRouteValueNames);
    builder.SetVaryByQuery(profile.Value.VaryByQueryKeys);
    
    // 重点：添加动态标签的回调
    builder.OnCreatingEntry(context =>
    {
        // 从HttpContext里获取当前的SubPageType实例
        var currentPage = context.HttpContext.Items["currentPage"] as SubPageType;
        // 如果你的CMS是通过路由参数传页面ID，也可以直接拿：
        // var pageId = context.HttpContext.GetRouteValue("pageId")?.ToString();
        
        if (currentPage != null)
        {
            // 优先用页面唯一ID当标签（避免URL修改导致驱逐失效）
            var dynamicPageTag = $"page_{currentPage.Id}";
            context.Entry.Tags.Add(dynamicPageTag);
        }
        return ValueTask.CompletedTask;
    });
});

第二步：把当前页面传入HttpContext #

上面的代码需要从HttpContext.Items里取到currentPage，所以我们写个简单的Action过滤器来把页面实例存进去：

public class CurrentPageCacheTagFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        // 从Action参数里取出currentPage
        if (context.ActionArguments.TryGetValue("currentPage", out var pageObj) && pageObj is SubPageType currentPage)
        {
            context.HttpContext.Items["currentPage"] = currentPage;
        }
    }

    public void OnActionExecuted(ActionExecutedContext context)
    {
        // 这里不需要额外操作
    }
}

然后把这个过滤器注册到全局，或者只加到需要缓存的Controller/Action上：

// 全局注册示例
builder.Services.AddControllersWithViews(options =>
{
    options.Filters.Add<CurrentPageCacheTagFilter>();
});

// 或者单个Action上用[ServiceFilter(typeof(CurrentPageCacheTagFilter))]标记

第三步：实现单条缓存的精准驱逐 #

现在每个缓存条目都有了专属标签，接下来驱逐某条缓存就很简单了——注入IOutputCacheStore，调用它的EvictByTagAsync方法：

public class CacheEvictionService
{
    private readonly IOutputCacheStore _cacheStore;

    public CacheEvictionService(IOutputCacheStore cacheStore)
    {
        _cacheStore = cacheStore;
    }

    // 传入目标页面，直接驱逐它的缓存
    public async Task EvictSinglePageCacheAsync(SubPageType targetPage)
    {
        var targetTag = $"page_{targetPage.Id}";
        await _cacheStore.EvictByTagAsync(targetTag, CancellationToken.None);
    }
}

之后你在需要的场景（比如CMS页面编辑保存后），注入这个CacheEvictionService并调用方法，就能精准驱逐对应页面的缓存了。

额外小提醒 #

• 比起用URL当标签，优先用页面唯一ID更靠谱，因为CMS里的页面URL可能会被修改，而ID一般不会变，驱逐逻辑更稳定。
• 不管你用内存缓存还是分布式缓存（比如Redis），这个逻辑都能正常工作，.NET 8的OutputCache对两种存储都支持标签驱逐。
• 完全不需要自定义OutputCacheAttribute，内置的OnCreatingEntry回调已经能满足动态加标签的需求，没必要额外造轮子。

备注：内容来源于stack exchange，提问作者Eric Herlitz