ASP.NET Core 中的输出缓存如何配置？-C#.Net教程-PHP中文网

ASP.NET Core 中的输出缓存如何配置？

月夜之吻

发布： 2025-10-13 10:15:01

原创

179人浏览过

ASP.NET Core 7引入统一输出缓存机制，通过AddOutputCache和UseOutputCache注册服务与中间件，支持全局、命名及匿名策略，可基于时间、查询参数、请求头等条件精细控制缓存行为，适用于Minimal API与控制器，提升性能并降低服务器负载。

asp.net core 中的输出缓存如何配置？

ASP.NET Core 中的输出缓存通过 Output Caching 中间件实现，主要用于缓存整个 HTTP 响应内容，提升性能。从 ASP.NET Core 7 开始，官方引入了统一的输出缓存机制，取代了旧版中功能有限的 [OutputCache] 特性。

启用输出缓存服务

在 Program.cs 中注册输出缓存服务：

调用 AddOutputCache() 添加缓存服务
使用 UseOutputCache() 启用中间件

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddOutputCache();

var app = builder.Build();
app.UseOutputCache();

配置缓存策略

可以定义命名策略或基于规则的方式控制缓存行为。

全局策略：对所有端点生效
命名策略：按名称引用，灵活分配给特定路由或控制器
匿名策略：直接应用于某个终结点

示例：定义一个缓存 60 秒的命名策略

builder.Services.AddOutputCache(options =>
{
options.AddPolicy("Default", context => context.Expire(TimeSpan.FromSeconds(60)));
});

在终结点上应用缓存

有多种方式将缓存策略绑定到具体请求处理逻辑。

存了个图

视频图片解析/字幕/剪辑，视频高清保存/图片源图提取

查看详情

Minimal API 中使用

app.MapGet("/time", () => DateTime.Now.ToString())
.CacheOutput("Default");

控制器中使用特性

[ApiController]
[Route("[controller]")]
public class TimeController : ControllerBase
{
[HttpGet]
[OutputCache(PolicyName = "Default")]
public IActionResult Get() => Ok(DateTime.Now);
}

自定义缓存条件

可基于请求头、查询参数、路径等决定是否参与缓存。

例如：仅当用户未登录且请求为 GET 时缓存

options.AddPolicy("AnonymousGet", context =>
{
var isGet = context.HttpContext.Request.Method == "GET";
var isAuthenticated = context.HttpContext.User.Identity?.IsAuthenticated == true;
if (!isGet || isAuthenticated)
{
context.NoCache();
}
else
{
context.Expire(TimeSpan.FromMinutes(5));
}
});

该机制支持细粒度控制，比如排除某些查询参数、设置 vary headers（如 Vary by Query Keys、Vary by Header）等。

常见配置选项

Expire(TimeSpan)：设置过期时间
VaryByQueryKeys(new[] {"id"})：根据查询参数变化缓存
VaryByHeader("Accept-Language")：根据请求头区分缓存版本
NoCache()：跳过缓存

例如：根据不同地区语言缓存不同版本

options.AddPolicy("Localized", context =>
{
context.VaryByHeader("Accept-Language")
.Expire(TimeSpan.FromHours(1));
}); 基本上就这些。合理配置输出缓存能显著减少服务器负载，加快响应速度。注意避免对个性化内容误用缓存。

以上就是ASP.NET Core 中的输出缓存如何配置？的详细内容，更多请关注php中文网其它相关文章！