.NET Core 6非通配符Endpoint限流规则不生效问题排查

.NET Core 6 IP限流特定接口规则不生效问题解决 #

问题分析 #

你遇到的是AspNetCoreRateLimit库中特定端点限流规则不生效的问题，核心原因集中在中间件顺序、路由匹配逻辑和配置完整性三个方面。

解决步骤 #

1. 修正中间件顺序与端点映射

UseIpRateLimiting必须放在UseRouting之后、UseEndpoints之前，且必须配置端点映射才能让限流中间件正确识别控制器路由。修改Startup.Configure方法：

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();
    
    // 限流中间件必须位于UseRouting和UseEndpoints之间
    app.UseIpRateLimiting();
    
    // 添加端点映射，确保路由系统解析控制器端点
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapControllers();
    });
}

2. 调整端点规则匹配逻辑

AspNetCoreRateLimit的Endpoint规则匹配的是规范化的路由模板或请求路径：

• 你的控制器路由是api/[controller]，对应实际路由为api/Waternet
• 原规则get:/api/waternet/*会匹配以/api/waternet/（带末尾斜杠）开头的路径，与实际请求路径不匹配

调整规则为以下任意一种：

// 匹配该控制器下所有GET请求
new RateLimitRule { Endpoint = "get:/api/waternet", Limit = 3, Period = "10s" },
// 匹配以/api/waternet开头的所有请求（忽略大小写和末尾斜杠）
new RateLimitRule { Endpoint = "*:/api/waternet*", Limit = 3, Period = "10s" }

3. 显式配置限流核心选项

确保开启端点限流开关，避免全局规则覆盖：

services.Configure<IpRateLimitOptions>(opt => 
{ 
    opt.GeneralRules = rateLimitRules;
    // 显式启用端点限流（默认已开启，防止配置被覆盖）
    opt.EnableEndpointRateLimiting = true;
    // 开启限流响应头，便于调试
    opt.EnableRateLimitHeaders = true;
});

4. 验证版本兼容性

确保使用的AspNetCoreRateLimit版本支持.NET Core 6，推荐安装4.x及以上版本（通过NuGet安装），旧版本可能存在路由匹配bug。

调试验证 #

可以在控制器中打印当前端点信息，确认限流中间件能正确获取路由模板：

[HttpGet]
public async Task<ActionResult<List<APIGetWaternetModel>>> GetFlowData(string companyGuid, ...)
{
    var endpoint = HttpContext.GetEndpoint();
    if(endpoint != null)
    {
        Console.WriteLine($"当前端点路由模板: {endpoint.DisplayName}");
    }
    // 原有业务逻辑...
}

根据打印出的路由模板调整限流规则，确保完全匹配。

内容的提问来源于stack exchange，提问作者WebInspired