ASP.NET Core输出缓存中间件实战指南

ASP.NET Core输出缓存中间件实战指南

practical-aspnetcore 该项目提供了关于ASP.NET Core实际应用开发的一系列教程和示例，涵盖了从基础知识到高级主题，是一个实用的学习资源库。适合于想要掌握ASP.NET Core技术栈的开发者进行学习和参考。 项目地址: https://gitcode.com/gh_mirrors/pr/practical-aspnetcore

输出缓存概述

在Web应用开发中，输出缓存(Output Cache)是一种重要的性能优化技术，它可以将动态生成的响应内容缓存起来，在后续请求中直接返回缓存结果，从而减少服务器处理负担，显著提升应用响应速度。

基础用法

基本配置

最简单的输出缓存配置只需要在中间件管道中添加UseOutputCache调用，并配置基本的缓存策略。这种方式适用于对全局所有响应进行相同缓存规则的场景。

app.UseOutputCache();

// 在服务配置中添加
services.AddOutputCache(options => {
    options.AddBasePolicy(builder => builder.Cache());
});

进阶功能

基于查询字符串的缓存

在实际应用中，我们经常需要根据不同的查询参数缓存不同版本的响应。例如，一个商品详情页可能根据不同的商品ID返回不同内容：

builder.Services.AddOutputCache(options => {
    options.AddPolicy("QueryVary", builder => 
        builder.VaryByQuery("id", "page"));
});

标签管理与缓存清除

对于需要主动清除特定缓存项的场景，可以使用标签机制：

// 添加带标签的缓存策略
options.AddPolicy("Tagged", builder => 
    builder.Tag("products"));

// 清除特定标签的缓存
await cacheStore.EvictByTagAsync("products", default);

策略配置

全局策略

可以配置全局基础策略，例如缓存所有包含特定查询参数的请求：

options.AddBasePolicy(builder => 
    builder.With(c => c.HttpContext.Request.Query.ContainsKey("cache")));

路径匹配策略

对于特定路径模式的请求可以应用特殊缓存规则：

options.AddBasePolicy(builder => 
    builder.SetVaryByQuery("*").Expire(TimeSpan.FromSeconds(30)));

自定义策略

更复杂的场景可以创建命名策略并在不同端点应用：

options.AddPolicy("TenMinutes", builder => 
    builder.Expire(TimeSpan.FromMinutes(10)));

// 在端点应用
app.MapGet("/long", () => DateTime.Now.ToString()).CacheOutput("TenMinutes");

缓存过期控制

精确控制缓存有效期是输出缓存的关键功能：

// 设置10分钟过期
options.AddPolicy("Expire10", builder => 
    builder.Expire(TimeSpan.FromMinutes(10)));

最佳实践

1. 合理设置缓存时间：根据数据变更频率设置，静态内容可以设置较长时间，动态内容适当缩短

2. 区分缓存粒度：对于个性化内容，确保缓存键包含区分用户的要素

3. 及时清除缓存：数据更新后，通过标签机制及时清除相关缓存

4. 监控缓存命中率：通过性能计数器监控缓存效果，优化策略

输出缓存中间件为ASP.NET Core应用提供了灵活高效的缓存能力，合理使用可以显著提升应用性能，特别是在高并发场景下效果更为明显。开发者应根据具体业务需求，选择合适的缓存策略和参数配置。

practical-aspnetcore 该项目提供了关于ASP.NET Core实际应用开发的一系列教程和示例，涵盖了从基础知识到高级主题，是一个实用的学习资源库。适合于想要掌握ASP.NET Core技术栈的开发者进行学习和参考。 项目地址: https://gitcode.com/gh_mirrors/pr/practical-aspnetcore