ASP.NET Core 中的速率限制中间件如何配置?

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

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
方法即可精细控制不同接口的访问频率。

相关推荐