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

来源：这里教程网时间：2026-02-21 17:36:07 作者：

为什么直接 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 连接中断时，