Spring Boot 2.3.0.RELEASE集成bucket4j接口限流不生效问题咨询

问题排查方向 #

• 版本兼容性问题
  你使用的bucket4j-spring-boot-starter 0.4.0仅适配Spring Boot 2.x版本，若当前项目使用Spring Boot 3.x，会出现配置不加载的问题，请确认Spring Boot版本匹配。
• 缺少限流维度配置
  当前配置中rate-limits节点下未指定限流标识规则，0.4.0版本需显式配置expression参数指定限流维度，比如按请求IP限流需要补充配置：

bucket4j:
  filters:
    - rate-limits:
        - expression: "getRemoteAddress()"
          bandwidths:
            - capacity: 2
              time: 1
              unit: minutes

如果需要全局维度限流，可配置expression: "'global'"即可。

• 过滤器优先级过低
  如果项目中集成了Spring Security、跨域过滤器等其他前置过滤器，可能请求在到达bucket4j过滤器前就已经被处理返回。可在filters节点下手动调高bucket4j过滤器优先级：

bucket4j:
  filters:
    - filter-order: -10000

• 缓存配置未生效

1. 检查启动日志是否存在JCache、ehcache相关报错，确认ehcache.xml被正常加载，名为buckets的缓存实例初始化成功
2. 确认@EnableCaching注解添加在启动类或被Spring上下文扫描到的配置类上
3. 检查是否缺失JCache API依赖，可在pom中补充：

<dependency>
    <groupId>javax.cache</groupId>
    <artifactId>cache-api</artifactId>
</dependency>

• 依赖冲突问题
  执行mvn dependency:tree检查bucket4j相关依赖是否存在冲突，排除其他组件引入的不同版本bucket4j核心包即可。

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