配置速率限制中间件
按端点和策略应用速率限制。
配置速率限制中间件 是 CoddyKit 上的免费 C# Academy 课时。 这是第 2 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 C# Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 C# Academy 课程共包含 4 节课。
AddRateLimiter
配置从服务容器中的 AddRateLimiter 开始。您可以定义一个或多个命名策略，以及可选的全局拒绝状态代码。
builder.Services.AddRateLimiter(options =>
{
options.RejectionStatusCode =
StatusCodes.Status429TooManyRequests;
});固定窗口策略
AddFixedWindowLimiter 注册命名策略。设置许可数量、窗口长度和队列行为。
options.AddFixedWindowLimiter("fixed", limiter =>
{
limiter.PermitLimit = 100;
limiter.Window = TimeSpan.FromMinutes(1);
limiter.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
limiter.QueueLimit = 0;
});滑动窗口策略
AddSlidingWindowLimiter 添加 SegmentsPerWindow，用于控制平滑粒度。
options.AddSlidingWindowLimiter("sliding", limiter =>
{
limiter.PermitLimit = 100;
limiter.Window = TimeSpan.FromMinutes(1);
limiter.SegmentsPerWindow = 6;
limiter.QueueLimit = 0;
});令牌桶策略
AddTokenBucketLimiter 设置桶容量和补充速率。
options.AddTokenBucketLimiter("token", limiter =>
{
limiter.TokenLimit = 100;
limiter.TokensPerPeriod = 20;
limiter.ReplenishmentPeriod = TimeSpan.FromSeconds(10);
limiter.QueueLimit = 0;
});并发策略
AddConcurrencyLimiter 限制同时处理的请求数。
options.AddConcurrencyLimiter("concurrent", limiter =>
{
limiter.PermitLimit = 5;
limiter.QueueLimit = 10;
limiter.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
});添加中间件
使用 UseRateLimiter 在管道中启用速率限制。将其放在路由之后尽早执行。
var app = builder.Build();
app.UseRateLimiter();
app.MapControllers();RequireRateLimiting
使用 RequireRateLimiting（最小 API）或 [EnableRateLimiting] 特性（控制器）将命名策略应用于端点。
app.MapGet("/search", () => Results.Ok())
.RequireRateLimiting("token");
// Controller equivalent:
// [EnableRateLimiting("token")]在特定端点上禁用
使用 DisableRateLimiting 或 [DisableRateLimiting]，使端点免受组级或全局限制器的限制。
app.MapGet("/health", () => Results.Ok())
.DisableRateLimiting();带分区的全局限制器
GlobalLimiter 应用于每个请求。使用 PartitionedRateLimiter.Create 为每个用户或 IP 提供独立的计数器。
options.GlobalLimiter = PartitionedRateLimiter.Create<HttpContext, string>(
context =>
{
var key = context.User.Identity?.Name
?? context.Connection.RemoteIpAddress?.ToString()
?? "anon";
return RateLimitPartition.GetFixedWindowLimiter(key, _ =>
new FixedWindowRateLimiterOptions
{
PermitLimit = 100,
Window = TimeSpan.FromMinutes(1)
});
});自定义拒绝响应
OnRejected 允许您在请求受到节流时添加 Retry-After 标头或易读的响应正文。
options.OnRejected = async (context, token) =>
{
if (context.Lease.TryGetMetadata(
MetadataName.RetryAfter, out var retry))
context.HttpContext.Response.Headers.RetryAfter =
((int)retry.TotalSeconds).ToString();
await context.HttpContext.Response
.WriteAsync("Rate limit exceeded.", token);
};应用于路由组
将策略附加到整个路由组，使其中的每个端点共享该限制。
var api = app.MapGroup("/api")
.RequireRateLimiting("fixed");
api.MapGet("/products", () => Results.Ok());
api.MapGet("/orders", () => Results.Ok());快速检查
请确认中间件的设置。
回顾
您配置了速率限制：
AddRateLimiter定义固定窗口、滑动窗口、令牌桶和并发策略。UseRateLimiter启用中间件；RequireRateLimiting应用策略。- 使用
GlobalLimiter和PartitionedRateLimiter可以为每个客户端提供独立计数器。 OnRejected自定义 429 响应。
接下来：输出缓存。
常见问题解答
「配置速率限制中间件」课时是免费的吗？
是的 — 「配置速率限制中间件」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 C# Academy 课程的其余内容，请升级到 CoddyKit PRO。 C# Academy 课程共包含 4 节课。
「配置速率限制中间件」这节课中我会学到什么？
按端点和策略应用速率限制。 你通过在浏览器中直接运行的动手代码来练习 C# Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 C# Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 C# Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 2 节课，共 4 节。
「配置速率限制中间件」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 C# Academy 课中编写并运行代码吗？
能。每节 C# Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。