ASP.NET Core 6 应使用 Microsoft.Extensions.Caching.StackExchangeRedis 封装的 IDistributedCache而非直连 StackExchange.Redis需显式序列化、设过期时间、防穿透/击穿/雪崩并用 redis-stack-server 本地开发。ASP.NET Core 6 默认用 IDistributedCache 接 Redis别自己封装 StackExchange.Redis 客户端直接暴露 ConnectionMultiplexer 容易导致连接泄漏、序列化不一致、超时配置错乱。微软的 Microsoft.Extensions.Caching.StackExchangeRedis 包已封装好线程安全、连接复用和异常重试逻辑且与 ILogger、IOptions 深度集成。常见错误现象Timeout performing GET 频发、缓存键大小写不一致导致命中失败、JSON序列化后类型丢失。注册时必须用 AddStackExchangeRedisCache而非手动 AddSingletonIConnectionMultiplexer连接字符串里不要硬编码 connectTimeout5000 —— 它会被 ConfigurationOptions.ConnectTimeout 覆盖而后者默认是 5s生产环境建议设为 10–15s避免在 Startup.ConfigureServices 中调用 GetDatabase() 获取实例 —— 这会提前触发连接且破坏 DI 生命周期管理IDistributedCache.SetAsync 存的是字节数组不是对象别漏了序列化它底层不做任何序列化传入 new byte[] { 1, 2, 3 } 就存什么取出来也一样。如果你直接传 JsonSerializer.SerializeToUtf8Bytes(obj)那读取时就得对应 JsonSerializer.DeserializeT(bytes)否则就是 NullReferenceException 或 JSON 解析失败。使用场景存 DTO、配置片段、计算结果等短生命周期数据不适合存大文件或未压缩的二进制流Redis 单 key 建议 ≤ 1MB。推荐统一用 System.Text.Json避免 Newtonsoft.Json 引入额外依赖和兼容性问题设置过期时间必须显式传 new DistributedCacheEntryOptions().SetAbsoluteExpiration(TimeSpan.FromMinutes(10))不传就永不过期注意 SetAsync 不会自动处理 null 值 —— 传 null 会存空字节数组读出来也是非 null 的空数组业务层要主动判空Redis 缓存穿透、击穿、雪崩在 C# 层能做的只有“缓存空值 逻辑过期”Redis 本身不解决这三类问题得靠代码逻辑兜底。比如查数据库返回 null你不能跳过缓存直接返回而应把 或特殊标记如 {exists:false}连同短 TTL如 2 分钟一起写入缓存。 Mokker AI AI产品图添加背景