C# Academy · 课时

输出缓存基础

Q: 「输出缓存基础」这节课中我会学到什么？

缓存响应以减少处理工作。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

缓存响应以减少处理工作。

输出缓存基础 是 CoddyKit 上的免费 C# Academy 课时。这是第 3 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。

什么是输出缓存

输出缓存会存储端点的完整 HTTP 响应，使重复请求可以直接从缓存中返回，而无需重新运行处理程序。对于以读取为主的端点，这可以大幅降低延迟和负载。

// First call -> handler runs, response stored
// Next calls -> response served from cache

输出缓存与响应缓存的区别

内置的输出缓存（在 .NET 7 中加入）会将响应存储在服务器上，并由您完全控制。较旧的响应缓存只会发送 HTTP 缓存标头，并依赖客户端或代理遵守这些标头。

// Output caching: server-side store you control
// Response caching: just Cache-Control headers

AddOutputCache

使用 AddOutputCache 注册服务。

builder.Services.AddOutputCache();

UseOutputCache

使用 UseOutputCache 将中间件添加到管道中。将其放在路由之后；如果存在 CORS，则放在 CORS 之后。

var app = builder.Build();

app.UseOutputCache();

app.MapControllers();

在端点上使用 CacheOutput

使用 CacheOutput（最小 API）或 [OutputCache] 特性（控制器）为端点启用缓存。

app.MapGet("/products", GetProducts)
   .CacheOutput();

// Controller:
// [OutputCache]
// public IActionResult Get() => Ok(...);

设置过期时间

使用 Expire 控制响应在缓存中保留的时长。

app.MapGet("/products", GetProducts)
   .CacheOutput(policy => policy.Expire(TimeSpan.FromSeconds(30)));

缓存哪些内容

默认情况下，只有状态码为 200 的 GET 和 HEAD 请求会被缓存，并且请求中不能涉及 Set-Cookie 或身份验证——错误地缓存经过身份验证的特定用户响应是危险的。

// Cached by default: GET/HEAD, 200, no cookies/auth

按查询字符串区分

通常，应分别缓存对同一路径但查询字符串不同的两个请求。请使用 SetVaryByQuery。

app.MapGet("/search", Search)
   .CacheOutput(policy => policy
        .Expire(TimeSpan.FromSeconds(60))
        .SetVaryByQuery("q", "page"));

按标头区分

您可以根据标头改变缓存键——例如，为每种 Accept-Language 提供不同的缓存副本。

policy.SetVaryByHeader("Accept-Language");

适用于所有内容的基础策略

AddBasePolicy 会为每个端点应用默认设置，但各个端点仍可以覆盖该设置。

builder.Services.AddOutputCache(options =>
{
    options.AddBasePolicy(policy =>
        policy.Expire(TimeSpan.FromSeconds(10)));
});

为端点禁用缓存

如果基础策略会缓存所有内容，请使用 NoCache 排除动态端点。

app.MapGet("/cart", GetCart)
   .CacheOutput(policy => policy.NoCache());

快速检查

请确认这两项缓存功能之间的区别。

回顾

您学习了输出缓存的基础知识：

AddOutputCache + UseOutputCache 启用服务器端缓存。
CacheOutput / [OutputCache] 为端点启用缓存；Expire 设置缓存时长。
默认情况下，只缓存未经身份验证且不包含 Cookie 的 GET/HEAD 200 响应。
SetVaryByQuery 和 SetVaryByHeader 共同决定缓存键。

下一步：缓存策略和失效处理。

常见问题解答

「输出缓存基础」课时是免费的吗？

是的 — 「输出缓存基础」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。

「输出缓存基础」这节课中我会学到什么？

缓存响应以减少处理工作。你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 C# Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 3 节课，共 4 节。

「输出缓存基础」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 C# Academy 课中编写并运行代码吗？

能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 C# Academy