You need to enable JavaScript to run this app. Spring Boot集成Hazelcast集群缓存无法跨实例共享问题咨询
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.29 06:06:04