C#怎么使用MemoryCache进行缓存 .NET内存缓存使用教程

在现代.NET应用开发体系中，合理引入内存缓存机制能够大幅削减重复计算与高频数据库查询带来的系统开销，从而显著提升整体响应速度与吞吐量。MemoryCache作为.NET生态中原生支持的内存缓存组件，主要面向单机部署环境或无需跨进程共享数据的业务场景。其设计哲学偏向轻量级与易用性，通过提供开箱即用的API接口，开发者可以快速构建具备过期控制、优先级调度及事件监听能力的本地缓存层。

核心机制解析与服务容器集成

MemoryCache的运行逻辑建立在.NET依赖注入框架之上，其底层实现位于特定的扩展库命名空间中。该组件对外暴露的核心抽象为IMemoryCache接口，开发者只需通过标准的构造函数注入方式即可获取实例。这种设计不仅符合单一职责原则，还使得缓存模块能够与其他业务服务无缝解耦。在当下主流的.NET版本中，该依赖通常已随运行时基础库一同发布，但在部分历史版本或精简型模板项目中，仍需通过包管理器显式补充相关引用，以确保编译期类型检查能够通过。

完成依赖准备后，下一步是将缓存服务注册到应用程序的生命周期容器中。这一过程通常在入口配置文件中完成，仅需调用内置的扩展方法即可完成服务映射。注册操作会在容器启动时初始化一个全局唯一的缓存实例，后续所有请求该接口的地方都会共享同一份内存空间。通过集中式配置，开发人员能够统一管控缓存的生命周期，避免因分散创建实例而导致的内存碎片化问题。

var builder = WebApplication.CreateBuilder(args);
// 将内存缓存服务注册至依赖注入容器
builder.Services.AddMemoryCache();
var app = builder.Build();

数据读写操作与生命周期调控

缓存的核心价值在于数据的快速存取与自动淘汰。写入操作依赖于Set方法，该方法允许传入键值对以及可选的配置参数。读取时推荐使用TryGetValue模式，相较于直接调用Get并处理空引用异常，此方式能够在一次原子操作中同时验证键的存在性与提取数据，有效降低代码中的防御性判断层级。当业务逻辑需要主动清理特定条目时，Remove方法提供了明确的销毁指令，确保无效或废弃的数据能够及时释放占用的堆内存。

为了平衡数据新鲜度与内存占用，框架提供了精细化的过期策略。绝对过期时间是指从数据写入时刻起算，经过固定时长后强制失效；滑动过期时间则关注访问频率，每次成功读取都会重置倒计时，若规定时间内未被触碰则自动淘汰。两者结合使用时，绝对过期充当硬性上限，滑动过期负责过滤长期闲置的冷数据。此外，当系统面临内存压力时，缓存引擎会根据预设的优先级队列执行驱逐算法，低优先级项将优先被回收，而标记为永不移除的项则会得到最高保护。

public void ConfigureCacheLifecycle()
{
    string cacheKey = "configuration_data";
    var configInfo = new { Version = 1.0, EnableFeature = true };

    // 设置过期策略与优先级
    var options = new MemoryCacheEntryOptions()
        .SetAbsoluteExpiration(TimeSpan.FromHours(1))
        .SetSlidingExpiration(TimeSpan.FromMinutes(15))
        .SetPriority(CacheItemPriority.High);

    // 注册条目淘汰回调事件
    options.RegisterPostEvictionCallback((key, value, reason, state) =>
    {
        Console.WriteLine(string.Format("Key: {0}, Reason: {1}", key, reason));
    });

    _memoryCache.Set(cacheKey, configInfo, options);
}

典型业务集成方案与工程规范

在实际的工程落地中，缓存通常以旁路模式介入核心业务流。以用户信息查询为例，服务层会首先尝试从内存中检索目标记录。若命中缓存则直接返回对象，避免穿透至持久层；若未命中，则按既定流程执行数据库查询。查询成功后，会将结果连同合理的过期策略一并写入缓存，形成完整的读放大优化闭环。这种模式既保证了数据的一致性边界可控，又最大化地发挥了本地缓存的加速效应。

为确保系统在复杂生产环境下的稳定性，必须遵循一系列工程实践准则。首先需明确该组件的物理边界仅限于当前进程，服务重启或横向扩容均会导致缓存状态归零，因此不适用于强一致性的分布式会话管理。其次，应严格控制单条缓存对象的体积，避免加载巨型集合引发垃圾回收停顿。键名设计需具备全局唯一性，建议采用业务域前缀加实体标识的组合方式，彻底杜绝不同模块间的命名冲突。最后，若存在复杂的联动失效需求，例如主配置变更需清除下游多个关联缓存，开发者需自行维护依赖图谱或借助外部事件总线，而非依赖内置的原生依赖特性。

public async Task<UserDto> FetchUserAsync(int targetId)
{
    string lookupKey = string.Format("user_profile_{0}", targetId);

    // 尝试从缓存获取数据
    if (_memoryCache.TryGetValue(lookupKey, out UserDto cachedProfile))
    {
        return cachedProfile;
    }

    // 缓存未命中时执行数据库查询
    var retrievedUser = await _databaseProvider.QueryUserAsync(targetId);
    if (retrievedUser != null)
    {
        // 回填缓存并设定时效规则
        var syncOptions = new MemoryCacheEntryOptions()
            .SetSlidingExpiration(TimeSpan.FromSeconds(30))
            .SetAbsoluteExpiration(TimeSpan.FromMinutes(10));
        _memoryCache.Set(lookupKey, retrievedUser, syncOptions);
    }

    return retrievedUser;
}

综上所述，掌握内存缓存的正确使用方式能够帮助开发者在性能优化与资源消耗之间找到最佳平衡点。通过合理配置过期策略、善用优先级调度机制以及严格遵守进程隔离边界，可以构建出高效且稳定的本地数据加速层。在后续的架构演进中，建议结合具体业务规模逐步评估是否需要向分布式缓存方案迁移，从而确保系统架构始终具备良好的可扩展性与维护性。

MemoryCacheC#缓存IMemoryCache修改时间：2026-07-06 09:27:33