直接 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.StackExchangeRedisNuGet 包 - 连接字符串格式为
"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 或不写入),不会抛异常。务必在关键路径加日志或健康检查验证连接可用性。










