Spring Cloud Gateway Redis Rate Limiter 每分钟请求数限制不生效问题求助

要实现特定路由每分钟最多4个请求，符合官方规则的配置参考如下：

spring:
  cloud:
    gateway:
      routes:
        - id: target_route_id
          uri: lb://target-service
          filters:
            - name: RequestRateLimiter
              args:
                redis-rate-limiter.replenishRate: 4
                redis-rate-limiter.requestedTokens: 60
                redis-rate-limiter.burstCapacity: 240
                keyResolver: "#{@customKeyResolver}" # 替换为实际使用的限流维度解析器

排查步骤 #

1. 配置规则校验 #

• 确认三个核心参数的赋值逻辑正确：replenishRate为时间窗口内允许的请求总数，requestedTokens为时间窗口对应的秒数，burstCapacity严格等于前两个参数的乘积，禁止随意调整三者的比例关系
• 检查配置的生效范围：确认该限流规则绑定到了目标路由上，避免全局限流配置覆盖路由级配置，路由级配置的优先级高于全局配置
• 排除参数拼写错误：检查是否误写为requestedToken（缺s）、replenishrate（大小写错误）这类配置不生效的低级问题

2. Redis 状态校验 #

• 登录限流使用的Redis实例，查看限流生成的相关key（默认命名规则为request_rate_limiter.{目标路由ID}.{限流维度值}），对应会生成两个key，分别存储剩余令牌数、上次令牌填充的时间戳
• 验证请求触发后的数值变化：正常逻辑下，请求成功后剩余令牌数会扣减对应值，时间戳同步更新为当前时间；如果时间戳没有被正确持久化，会导致每次请求都重新计算令牌填充量，出现请求完成后令牌桶自动补满的异常
• 确认Redis没有配置过短的key过期策略，避免限流统计key被提前删除，导致每次请求都重置计数

3. 版本与自定义逻辑校验 #

• 检查Spring Cloud Gateway版本：低于Hoxton.SR8的版本存在低速率场景下的令牌填充逻辑bug，会导致低于1次/秒的限流规则不生效，需要升级到对应稳定版本修复
• 确认自定义KeyResolver的返回值稳定：同一个限流主体（如同一个IP、同一个用户）必须返回相同的key值，若返回值不稳定会导致同一个主体对应多个统计key，整体速率突破上限
• 排查自定义过滤器是否修改了限流判断结果：如果存在优先级高于RequestRateLimiter的自定义过滤器，可能会绕过限流逻辑或者重置限流状态

4. 基准功能验证 #

• 先简化场景做验证：配置1次/分钟的限流规则（replenishRate=1、requestedTokens=60、burstCapacity=60），连续发送请求验证：第一次请求成功，后续59秒内的所有请求都返回429状态码，若不符合则说明限流核心逻辑存在异常
• 多实例部署场景下，确认所有网关实例连接同一个Redis集群，且限流配置、key生成规则完全一致，避免不同实例分开计数导致速率突破上限

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