ASP.NET Core从.NET 7起内置速率限制中间件,通过AddRateLimiter注册服务并配置固定窗口、滑动窗口、令牌桶等策略,使用RequireRateLimiting为特定路由或全局应用限流规则,并可自定义拒绝响应处理逻辑。

ASP.NET Core 中的速率限制(Rate Limiting)可以通过内置的 Microsoft.AspNetCore.RateLimiting 中间件来实现。从 .NET 7 开始,该功能已集成到框架中,无需引入第三方库即可配置基于固定窗口、滑动窗口、令牌桶等策略的限流规则。
启用速率限制中间件
要在项目中使用速率限制,需在 Program.cs 中注册服务并添加中间件:
var builder = WebApplication.CreateBuilder(args);
// 添加速率限制服务
builder.Services.AddRateLimiter(options =>
{
options.AddFixedWindowLimiter(policyName: "fixed", context =>
{
context.PermitLimit = 5; // 每窗口允许请求数
context.Window = TimeSpan.FromSeconds(10); // 窗口长度
context.QueueProcessingOrder = QueueProcessingOrder.OldestFirst;
context.QueueLimit = 1; // 排队请求上限
});
});
var app = builder.Build();
// 使用速率限制中间件
app.UseRateLimiter();
app.Run();
为路由或终结点应用限流策略
配置好策略后,可在具体路由上应用:
app.MapGet("/api/values", () => "Hello World")
.RequireRateLimiting("fixed");
也可以对整个应用统一启用:
app.UseRateLimiter();
app.UseRouting();
app.UseAuthorization();
app.MapControllers().RequireRateLimiting("fixed");
支持的限流策略类型
- Fixed Window:固定时间窗口内限制请求数量,适合简单场景
- Sliding Window:滑动窗口,更平滑地控制频率
- Token Bucket:基于令牌桶算法,允许短时突发流量
- Concurrency:限制最大并发请求数
例如使用令牌桶策略:
options.AddTokenBucketLimiter("token", context =>
{
context.TokenLimit = 10;
context.TokensPerPeriod = 2;
context.ReplenishmentPeriod = TimeSpan.FromSeconds(5);
});
自定义拒绝响应
可设置请求被拒绝时的处理逻辑:
options.OnRejected = (context, cancellationToken) =>
{
context.HttpContext.Response.StatusCode = 429;
return context.HttpContext.Response.WriteAsync("Too many requests.");
};
基本上就这些。配置灵活,结合策略名称和RequireRateLimiting 方法即可精细控制不同接口的访问频率。









