掌握ASP.NET Core中HTTP响应缓存的策略与实践

原创于 2025-05-10 11:10:18 发布 · 369 阅读

CC 4.0 BY-SA版权

文章标签：

#ASP.NET Core #HTTP响应缓存 #ResponseCache属性 #缓存配置文件 #ETag和Last-Modified

背景简介

ASP.NET Core是微软开发的一个高性能、跨平台的开源Web开发框架。响应缓存是优化Web应用性能的一个重要方面，它可以帮助减少服务器负载、加速响应时间。本文将基于ASP.NET Core中的响应缓存机制，通过具体的代码示例和实际案例，探讨如何在API中实现有效的HTTP响应缓存策略。

缓存响应的基础设置

在ASP.NET Core中，可以通过在控制器动作上应用[ResponseCache]属性来快速设置缓存。例如，设置缓存持续时间为60秒：

[HttpGet("{id}")]
[ResponseCache(Duration = 60)]
public async Task<IActionResult> GetCompany(Guid id)
{
    // ...
}

这将为GetCompany动作的响应添加一个Cache-Control头部，指示它可以被缓存60秒。然而，为了实现真正的缓存存储，还需要在服务配置中注册ResponseCaching服务，并在应用中间件中启用它：

public static void ConfigureResponseCaching(this IServiceCollection services) => 
    services.AddResponseCaching();

// 在ConfigureServices方法中
services.ConfigureResponseCaching();

// 在Configure方法中
app.UseResponseCaching();

缓存配置文件的使用

为了简化和标准化缓存设置，ASP.NET Core支持缓存配置文件的概念。通过修改AddControllers方法，可以为不同的资源应用相同的缓存规则：

services.AddControllers(config => {
    config.CacheProfiles.Add("120SecondsDuration", new CacheProfile { Duration = 120 });
});

// 在控制器上应用缓存配置文件
[ApiController]
[ResponseCache(CacheProfileName = "120SecondsDuration")]
public class CompaniesController : ControllerBase
{
    // ...
}

缓存过期与验证模型

ASP.NET Core中的缓存过期模型允许服务器识别响应是否已过期。客户端在请求时，如果缓存的响应未过期，则直接从缓存中提供。如果过期，则请求将被转发到API。为了验证响应的新鲜度，可以使用ETag和Last-Modified头信息：

// API端
public async Task<IActionResult> GetCompany(Guid id)
{
    // ...
    Response.Headers.Add("ETag", "some-value");
    return Ok();
}

// 客户端请求
var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, url);
request.Headers.IfNoneMatch.Add(new EntityTagHeaderValue("\"some-value\""));
var response = await client.SendAsync(request);

如果ETag匹配，则API返回304 Not Modified状态，响应从缓存中提供；否则，API重新生成响应并返回。