ASP.NET Core 中的响应缓存如何配置?

来源:这里教程网 时间:2026-02-21 17:26:38 作者:

在 ASP.NET Core 中配置响应缓存,主要是通过 Response Caching Middleware 实现,它可以缓存服务器端的响应内容,减少重复请求对后端资源的消耗。要正确启用和使用响应缓存,需要完成以下几个步骤。

启用响应缓存中间件

要在项目中使用响应缓存,首先需要在 Program.cs 中注册相关服务和中间件:

builder.Services.AddResponseCaching();

// 添加响应缓存服务

var app = builder.Build();

app.UseResponseCaching();

// 确保在调用 UseRouting 之后、UseEndpoints 之前使用中间件

使用 ResponseCache 特性控制缓存行为

最常见的方式是通过 [ResponseCache] 特性来配置单个控制器或 Action 的缓存策略。这个特性会设置响应头中的 Cache-Control、Expires、Vary 等字段。

示例:

[HttpGet("products")]

[ResponseCache(Duration = 60, Location = ResponseCacheLocation.Any, NoStore = false)]

public IActionResult GetProducts()

{

var products = _productService.GetAll();

return Ok(products);

}

说明:

Duration=60:表示响应将被缓存 60 秒 Location=Any:允许代理和客户端都缓存 NoStore=false:允许存储缓存

配置更复杂的缓存策略(可选)

如果需要更灵活的控制,比如基于请求头或自定义逻辑决定是否缓存,可以结合中间件和手动设置响应头:

HttpContext.Response.GetTypedHeaders().CacheControl = new Microsoft.Net.Http.Headers.CacheControlHeaderValue()

{

Public = true,

MaxAge = TimeSpan.FromSeconds(120)

};

HttpContext.Response.Headers["Vary"] = new string[] { "Accept-Encoding" };

这种方式适合在中间件或 Action 内部动态控制缓存行为。

注意点和限制

响应缓存中间件只缓存成功(状态码 200)的 HTTP GET 或 HEAD 请求。以下情况不会缓存:

响应已包含 Cache-Control: no-cache 请求方法不是 GET 或 HEAD 响应已经写入内容且状态码非 2xx 启用了 NoStore 并设置了 private 缓存

另外,该中间件是**内存缓存**,不支持分布式场景。如需跨服务器共享缓存,建议结合 Redis 或 CDN 使用。

基本上就这些。合理使用响应缓存能显著提升接口性能,尤其是在数据变化不频繁的场景下。关键是根据业务需求设置合适的 Duration 和 Vary 头。

相关推荐