Spring Boot集成Hazelcast集群缓存无法跨实例共享问题咨询
问题排查与解决方案
核心现象
- 两个应用实例可正常完成Hazelcast集群组建,日志可识别到对等节点
- 第一个实例写入的缓存值,第二个实例请求时无法命中,仍触发耗时3秒的慢查询逻辑
- 通过Hazelcast管理中心可连接集群,但
books缓存对应的Map下无任何存储值 - 已尝试无效方案:分不同端口启动Jar包/外部Tomcat部署、将YAML的多播配置替换为Java代码配置,问题无改善
- 基础环境:Spring Boot 2.4.4,
application.properties无自定义配置
根因定位
问题的核心是Spring Cache层没有和已启动的Hazelcast实例做绑定:
虽然Hazelcast组件被Spring Boot自动初始化、成功组建了跨节点集群,但由于没有显式指定缓存实现类型,Spring Cache自动默认采用了本地内存的ConcurrentMapCacheManager做缓存存储。所有缓存值都存在每个应用实例的本地JVM内存中,完全没有写入跨节点的Hazelcast分布式Map——这就类似本地启动了Redis服务但业务代码始终把数据存在本地内存,Redis本身处于空跑状态,自然出现集群正常但缓存不共享、管理中心看不到缓存值的现象。
分步修复配置
- 第一步:显式指定Spring缓存实现类型
在application.properties中增加配置,强制Spring Cache使用Hazelcast作为底层实现:spring.cache.type=hazelcast - 第二步:确认依赖完整性
确保项目已引入缓存相关starter与Hazelcast集成依赖,避免桥接层缺失:- 引入
spring-boot-starter-cache(提供Spring Cache的注解支持与自动配置能力) - 引入Hazelcast对应的Spring Boot Starter(确保HazelcastInstance可被Spring容器识别、自动生成匹配的HazelcastCacheManager)
- 引入
- 第三步:排除本地缓存的优先级冲突
检查项目中是否存在手动定义的本地缓存CacheManagerBean(比如自定义的ConcurrentMapCacheManager),这类自定义Bean会覆盖Spring的自动配置逻辑,导致缓存实现回退到本地内存。如果存在,需要删除自定义的本地缓存配置,由Spring基于已指定的hazelcast类型自动生成分布式CacheManager。
效果验证
- 重启两个应用实例,先请求第一个实例的
/public/testcache/get/{isbn}接口,等待3秒获取结果 - 直接请求第二个实例的同路径接口,会瞬时返回结果,不再触发慢查询逻辑
- 打开Hazelcast管理中心,在Map列表下找到
books项,可看到之前存储的缓存键值对 - 调用任意一个实例的
/public/testcache/clear/cache接口,两个实例的分布式缓存会同步清空,再次请求时重新触发慢查询逻辑
内容的提问来源于stack exchange,提问作者Andrea
相关产品推荐
相关产品推荐

