c# 如何用IDistributedCache和Redis实现分布式缓存

直接 new redisCache 不行，因为 IDistributedCache 是抽象接口且 RedisCache 需由 DI 容器管理以确保连接复用、配置绑定和生命周期控制；手动实例化易致连接泄漏或 ObjectDisposedException。

为什么直接 new RedisCache 不行

ASP.net Core 的 IDistributedCache 是抽象接口，不能直接实例化。你看到的 RedisCache 类虽然存在，但它设计为由 DI 容器管理——手动 new 会绕过连接复用、配置绑定和生命周期控制，极易导致连接泄漏或 ObjectDisposedException。正确路径是通过 AddStackExchangeRedisCache 注册服务，并在需要处注入 IDistributedCache。

如何注册 Redis 分布式缓存（.NET 6+）

在 Program.cs 中配置 Redis 连接字符串和序列化行为。默认使用 System.Text.json 序列化，但要注意：它不支持 DateTimeKind.Unspecified 的反序列化精度丢失，也不处理循环引用。

• 确保已安装 microsoft.Extensions.Caching.StackExchangeRedis NuGet 包
• 连接字符串格式为 "localhost:6379,abortConnect=false,connectTimeout=5000"，不要加 redis:// 前缀
• 若需自定义序列化（如兼容旧 Newtonsoft.json 数据），必须实现 IDistributedCache 包装器，而非替换内部序列化逻辑

var builder = WebApplication.CreateBuilder(args); builder.Services.AddStackExchangeRedisCache(options => {     options.Configuration = builder.Configuration.GetConnectionString("Redis");     options.InstanceName = "myapp:"; });

IDistributedCache.SetAsync 存对象要先序列化吗

不用手动序列化。所有 IDistributedCache 实现（包括 Redis）都只接受 byte[]，但 SetAsync 等扩展方法已内置 System.Text.Json 序列化。你传入任意可序列化对象，框架自动处理：

• 值类型、简单类、record 都能直接存取
• 含 DateTimeOffset 或 TimeSpan 的对象默认保留精度
• 若对象含不可序列化字段（如 stream、委托），运行时抛 NotSupportedException，不是编译错误
• 缓存键（key）必须是合法 Redis key 字符串：不能含空格、控制字符，建议用 my:feature:id 格式

await cache.SetAsync("user:123", user, new DistributedCacheEntryOptions {     AbsoluteExpirationRelativeToNow = TimeSpan.FromMinutes(30),     SlidingExpiration = TimeSpan.FromMinutes(10) });

Redis 缓存失效后查数据库的典型模式

没有内置“缓存穿透防护”或“逻辑过期”支持，必须自己编码。常见组合是 GetOrCreateAsync + 异步工厂函数，但要注意：多个并发请求可能同时触发数据库查询（缓存击穿）。

• 用 GetAsync 先查缓存，为 NULL 再执行 DB 查询并 SetAsync
• 若需防击穿，对 key 加分布式锁（如用 Redis 的 SET key value NX PX 5000）
• 避免在 GetOrCreateAsync 工厂里写同步 IO（如 dbContext.Users.Find(id)），必须用 FindAsync
• 缓存空结果也要设较短过期时间（如 2 分钟），防止缓存穿透

最易忽略的是：Redis 连接中断时，IDistributedCache 默认静默失败（返回 null 或不写入），不会抛异常。务必在关键路径加日志或健康检查验证连接可用性。