.NET 4.6.2迁移至ASP.NET Core 8时找不到StackExchangeRedisCacheClient类

问题原因 #

StackExchange.Redis.Extensions套件适配ASP.NET Core生态时重构了API结构，原StackExchangeRedisCacheClient类已被废弃重命名，不再通过原StackExchange.Redis.Extensions.Core包直接提供，转而推荐用依赖注入的方式管理缓存客户端实例。

解决步骤 #

1. 安装正确的NuGet包

确保安装适配ASP.NET Core的套件及对应序列化包（二选一即可）：

• 使用Newtonsoft.Json序列化：

  Install-Package StackExchange.Redis.Extensions.AspNetCore
  Install-Package StackExchange.Redis.Extensions.Newtonsoft
  

• 使用System.Text.Json序列化：

  Install-Package StackExchange.Redis.Extensions.AspNetCore
  Install-Package StackExchange.Redis.Extensions.System.Text.Json
  

2. 配置依赖注入（推荐方式）

在Program.cs中注册Redis相关服务：

var builder = WebApplication.CreateBuilder(args);

// 方式一：注册基础IDistributedCache实现
builder.Services.AddStackExchangeRedisCache(options =>
{
    options.Configuration = builder.Configuration["Redis:ConnectionString"]; // 从配置文件读取连接串
    options.InstanceName = "MyApp:"; // 键前缀，避免不同应用缓存冲突
});

// 方式二：注册IRedisCacheClient（提供更丰富的缓存操作API）
builder.Services.AddStackExchangeRedisExtensions<NewtonsoftSerializer>(options =>
{
    options.Configuration = builder.Configuration["Redis:ConnectionString"];
    options.InstanceName = "MyApp:";
});

var app = builder.Build();
// ... 其他中间件配置

3. 注入并使用缓存客户端

在控制器或服务中通过构造函数注入对应接口，替代手动实例化：

// 使用IRedisCacheClient的示例
public class ProductService
{
    private readonly IRedisCacheClient _cacheClient;

    public ProductService(IRedisCacheClient cacheClient)
    {
        _cacheClient = cacheClient;
    }

    public async Task<Product?> GetProductFromCache(int productId)
    {
        var cacheKey = $"Product:{productId}";
        return await _cacheClient.Db0.GetAsync<Product>(cacheKey);
    }

    public async Task SetProductToCache(int productId, Product product)
    {
        var cacheKey = $"Product:{productId}";
        await _cacheClient.Db0.AddAsync(cacheKey, product, TimeSpan.FromMinutes(15));
    }
}

4. 手动实例化（不推荐，仅作兼容参考）

如果必须保留手动实例化逻辑，可使用重构后的RedisCacheClient类（注意类名变化）：

using StackExchange.Redis;
using StackExchange.Redis.Extensions.Core;
using StackExchange.Redis.Extensions.Newtonsoft;

// 创建连接复用器
var connectionMultiplexer = ConnectionMultiplexer.Connect("your-redis-connection-string");
// 实例化序列化器
var serializer = new NewtonsoftSerializer();
// 创建缓存客户端（替换原StackExchangeRedisCacheClient）
var cacheClient = new RedisCacheClient(connectionMultiplexer, serializer);

注意事项 #

• 优先使用依赖注入方式，ASP.NET Core的DI系统会自动管理ConnectionMultiplexer生命周期，避免连接泄漏问题。
• 连接串建议从appsettings.json读取，避免硬编码。

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