FF4J基于SpringJDBC的Feature Store配置Ehcache缓存不生效的问题咨询
FF4j 服务端缓存配置失效排查方案与验证方法
核心失效根因定位
1. 跨版本依赖链路断裂
- 当前项目中FF4j核心版本为1.8.7,但引入的
ff4j-webapi-jersey2x版本为1.8.11,跨版本的类加载与方法签名不匹配,会导致WebAPI层直接持有原始SpringJDBC FeatureStore实例,完全跳过带缓存的代理层,缓存逻辑从根上就没接入请求链路。 - 正确配置要求所有FF4j生态组件版本严格对齐,统一锁定同一版本号,避免版本不一致带来的代理类加载失败问题。
2. 缓存初始化顺序与挂载逻辑错误
- FF4j 1.8.x版本的缓存机制并非核心内置能力,而是通过
CachedFeatureStore装饰器对原始存储实例做一层包装实现的。 - 常见错误操作是:初始化FF4j实例时单独调用
setCacheProvider()传入EhCache/InMemory缓存实例,但依然把原始的SpringJDBC FeatureStore直接设置到FF4j实例上——这种操作等于给FF4j塞了一个无关联的缓存引用,完全不会触发缓存读写,自然会出现listCachedFeatureNames返回空的情况。 - 正确的初始化链路顺序为:
- 先基于数据源初始化原始的
SpringJdbcFeatureStore实例 - 初始化
FeatureCacheProviderEhCache实例,配置好缓存过期时间、最大容量等参数 - 通过装饰器生成带缓存的存储实例:
new CachedFeatureStore(原始SpringJDBC存储实例, 配置好的EhCache缓存提供者) - 把这个带缓存的包装类设置到FF4j实例中,替换掉原始的SpringJDBC存储实例
- 先基于数据源初始化原始的
3. 缓存懒加载机制的认知偏差
- FF4j的缓存默认采用懒加载模式,不会在服务启动时全量把数据库里的Feature预热到缓存中。只有当某个Feature被第一次查询时,才会从底层数据库读取内容并写入缓存,后续查询直接命中缓存。
- 服务刚启动时没有任何Feature被查询过,直接查看缓存内容必然是空集合,不属于配置错误。
- Web控制台的变更操作能即时同步,是因为默认实现中任何Feature写操作都会主动清除缓存中对应的条目,下次查询时重新从数据库拉取最新值写回缓存,并非缓存完全失效。
无需关停数据库的缓存生效验证方法
不需要停数据库、断数据源连接就能完成全链路验证,步骤如下:
- 分别在两个实现类中埋点打印查询日志:
- 在
CachedFeatureStore的read、check方法中加日志,标注"当前请求读取来源:缓存层" - 在
SpringJdbcFeatureStore的read、check方法中加日志,标注"当前请求读取来源:数据库层"
- 在
- 第一次调用
/api/ff4j/features/{目标FeatureID}接口,观察日志:首次请求会同时打印"缓存未命中"的记录和数据库层的查询记录,此时对应Feature已经被写入缓存 - 直接连接数据库,修改目标Feature的状态值(比如从开启改为关闭),不要走FF4j的Web控制台或API接口触发变更
- 再次调用同一个Feature的查询接口:如果接口返回的还是之前的旧状态(开启),且日志只打印缓存层的读取记录、没有触发数据库层的查询动作,即证明缓存已经正常生效
- 调用Web控制台的"清除缓存"按钮后,再一次调用接口,此时接口会从数据库拉取最新的关闭状态值,即可完成完整的闭环验证
常见踩坑补充提醒
- 仅给FF4j实例设置CacheProvider不会生效,必须通过
CachedFeatureStore完成对原始存储的包装,这是1.8.x版本的固定实现逻辑,无自动包装能力 - 自定义EhCache配置时,要注意默认的Feature缓存块名为
ff4jFeatures,块名写错会导致缓存实例拿不到对应存储块,出现缓存写入失败的问题 - 开启审计模式、配置独立的属性存储、事件仓库不会影响缓存逻辑,但要确保所有存储实例初始化完成后,再做缓存包装的操作
内容的提问来源于stack exchange,提问作者tushitjain
相关产品推荐
相关产品推荐

