.NET 8中Redis版OutputCache按testId失效缓存的问题

解决方案 #

1. 优先使用**标签（Tags）**实现精准失效 #

这是框架原生支持的最优方案，通过给不同testId的缓存条目绑定专属标签，实现精准清除：

步骤1：在控制器中配置缓存标签

修改OutputCache属性，使用路由参数{testId}生成专属标签：

[HttpGet]
[Route("test/{testId}")]
// 为每个testId生成唯一标签，格式为test-{testId}
[OutputCache(Duration = 600, Tags = new[] { "test-{testId}" })]
public async Task<IActionResult> GetAll(long testId)
{
    // 业务逻辑
}

框架会自动将路由中的testId值替换到标签中，比如testId=1时，标签为test-1。

步骤2：通过标签清除缓存

在需要清除缓存的地方（比如更新数据的接口），注入IOutputCacheStore并调用EvictByTagAsync：

private readonly IOutputCacheStore _outputCacheStore;

public YourController(IOutputCacheStore outputCacheStore)
{
    _outputCacheStore = outputCacheStore;
}

// 示例：更新test数据后清除对应缓存
[HttpPost]
public async Task<IActionResult> UpdateTest(long testId, TestModel model)
{
    // 执行更新业务逻辑
    // ...
    
    // 清除该testId对应的所有缓存条目
    await _outputCacheStore.EvictByTagAsync($"test-{testId}", HttpContext.RequestAborted);
    return Ok();
}

2. 理解Redis缓存键的本质 #

Redis中生成的__MSOCV_xxx格式键是框架内部维护的缓存键，包含请求方法、主机、路径、查询参数等哈希信息，不能直接作为标签使用。框架会单独维护标签与缓存键的映射关系，只有通过框架的标签API才能正确关联并清除缓存。

3. 自定义缓存键策略（可选） #

如果不想使用标签，可以自定义缓存键生成规则，让键包含testId，再通过Redis客户端批量删除匹配前缀的键：

步骤1：配置自定义缓存键生成器

builder.Services.AddOutputCache(options =>
{
    options.AddBasePolicy(builder => builder.Cache());
    options.AddPolicy("OutputCacheWithAuthPolicy", OutputCacheWithAuthPolicy.Instance);
    
    // 自定义缓存键，包含testId
    options.KeyBuilder = context =>
    {
        var testId = context.Request.RouteValues["testId"]?.ToString() ?? "unknown";
        return $"outputcache_test_{testId}_{context.Request.Method}_{context.Request.Path}";
    };
});

步骤2：通过Redis客户端清除缓存

注入Redis连接复用器IConnectionMultiplexer，批量删除匹配前缀的键：

private readonly IConnectionMultiplexer _redisMultiplexer;

public YourController(IConnectionMultiplexer redisMultiplexer)
{
    _redisMultiplexer = redisMultiplexer;
}

public async Task<IActionResult> ClearTestCache(long testId)
{
    var db = _redisMultiplexer.GetDatabase();
    var server = _redisMultiplexer.GetServer(_redisMultiplexer.Configuration);
    
    // 扫描匹配前缀的键（避免使用KEYS命令阻塞Redis）
    await foreach (var key in server.KeysAsync(pattern: $"outputcache_test_{testId}_*"))
    {
        await db.KeyDeleteAsync(key);
    }
    return Ok();
}

注意：此方法需要直接操作Redis，跳过了OutputCache框架的内部映射维护，仅在特殊场景下使用，优先推荐标签方案。

4. 确保依赖注入正确 #

无论是使用IOutputCacheStore还是IConnectionMultiplexer，都要确保服务已正确注册并注入到目标类中，避免出现空引用或无效实例的问题。

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