ASP.NET Core 8+ 原生 RateLimiter 必须注册策略并显式启用,否则不生效;FixedWindowRateLimiter 需用 TimeSpan 构造窗口、PermitLimit 表示总请求数、QueueLimit=0 直接返回429;路由需链式调用 RequireRateLimiting("name") 启用;UseRateLimiter() 必须在 UseRouting() 之后、UseEndpoints() 之前;SlidingWindowRateLimiter 未提供开箱即用实现;ConcurrencyLimiterMiddleware 与 RateLimiter 用途不同,不可混用。

ASP.NET Core 8+ 原生 RateLimiter 中间件能直接用,但必须配对注册策略 + 显式启用,漏一步就完全不生效。
FixedWindowRateLimiter 必须显式注册策略名
原生限流中间件不会自动启用任何策略。只调用 AddRateLimiter() 而不注册具体策略,运行时会抛 InvalidOperationException: No rate limiter policy is configured。
-
AddFixedWindowLimiter("fixed", opt => { ... })中的"fixed"是策略名,后续路由绑定或中间件启用都依赖它 -
Window必须用TimeSpan.FromMinutes(1)这类构造方式,不能写60000毫秒硬编码 -
PermitLimit是窗口内总请求数,不是并发数;QueueLimit = 0表示不排队,超限直接返回 429 - 若想让部分路由走限流、部分不走,得在
MapGet后链式调用RequireRateLimiting("fixed"),而不是全局拦截所有请求
UseRateLimiter() 的位置和顺序不能错
中间件本身不生效,常见原因是挂载顺序错误——它既不能太早,也不能太晚。
- 必须在
UseRouting()之后、UseEndpoints()或UseAuthorization()之后(但要在UseEndpoints()之前) - 如果用了
UseHttpsRedirection()或自定义认证中间件,UseRateLimiter()应放在它们之后、UseEndpoints()之前 - 策略名拼错(比如写成
"fixd")或没传入RequireRateLimiting(),请求压根不会被检查,也不会打日志 - 调试时可临时加
app.Use(async (ctx, next) => { Console.WriteLine("RateLimiter hit"); await next(); });确认是否走到这步
SlidingWindowRateLimiter 在 .NET 8/9 中并不存在
文档里提到的 SlidingWindowRateLimiter 类型只是抽象基类,官方并未提供开箱即用的实现。试图调用 AddSlidingWindowLimiter 会编译失败。
- 原生方案只能手写
IServerRateLimiter实现,需维护多个时间分片桶、做跨桶聚合,极易因时钟漂移或并发更新出错 - 生产环境别碰内存级滑动窗口——节点间不同步、重启丢数据、高并发下
ConcurrentDictionary锁争用严重 - 真正可行的替代:用
StackExchange.Redis+ Lua 脚本实现分布式滑动窗口,或退回到AspNetCoreRateLimit(虽已归档但仍稳定) - 若只是防突发流量,
TokenBucketLimiter(.NET 8+ 实验性 API)比硬上滑动窗口更轻量,但要注意它目前仍标记为[Experimental]
ConcurrencyLimiterMiddleware 和 RateLimiter 完全不是一回事
前者是控制「同时处理几个请求」,后者是控制「单位时间最多多少次请求」。混用会导致逻辑混乱甚至服务假死。
-
ConcurrencyLimiterMiddleware来自独立 NuGet 包Microsoft.AspNetCore.ConcurrencyLimiter,需手动引用 - 它本质是“队列+并发阈值”,超限时把请求塞进内存队列等待,不是拒绝;而
RateLimiter默认是直接拒绝(429) - 两者中间件注册顺序冲突:若同时启用,
UseConcurrencyLimiter()必须放在UseRateLimiter()之后,否则限流判断会被绕过 - 真实场景中,通常只选其一:后端资源紧张用并发限流,API 防刷/防滥用用速率限流
最容易被忽略的是策略作用域——限流规则默认不绑定到任何路径,你得明确告诉框架“这个策略管哪些路由”,否则再完整的配置也只是躺在 Program.cs 里吃灰。


















