Infinispan分布式同步缓存不可访问及初始状态传输超时排查

一、核心问题诊断 #

1. 集群缓存不共享问题 #

配置中设置了CacheMode.DIST_SYNC但节点间数据无法互通，核心原因是集群节点未成功完成发现与组网，或是状态同步相关配置缺失导致数据无法跨节点同步。

2. 启动阶段状态传输超时异常 #

异常核心提示Initial state transfer timed out for cache pair-executions-cache，说明缓存初始化时，节点间的状态同步操作超出了默认超时时间，直接导致缓存Bean创建失败，进而触发应用启动异常。

二、针对性解决方案 #

（一）解决集群节点发现与数据共享问题 #

1. 补全JGroups集群通信配置
   Infinispan依赖JGroups实现集群组网，必须确保所有节点使用一致的通信配置：

// 以TCP栈+固定节点发现为例，替换为实际节点信息
confBuilder.clustering().transport()
    .defaultTransport()
    .addProperty("jgroups.tcp.address", "0.0.0.0")
    .addProperty("jgroups.tcp.port", "7800")
    .addProperty("jgroups.tcpping.initial_hosts", "节点1IP:7800,节点2IP:7800")
    .addProperty("jgroups.tcpping.port_range", "1");

// K8s环境推荐使用DNS发现方式
confBuilder.clustering().transport()
    .defaultTransport()
    .addProperty("jgroups.dns.query", "你的服务名.命名空间.svc.cluster.local");

2. 完善分布式缓存配置
   补充分布式缓存的所有者数量配置（默认2，可根据集群规模调整），确保数据在集群内的副本分布符合预期：

confBuilder.clustering().hash().numOwners(2);

（二）解决启动阶段状态传输超时问题 #

1. 延长状态传输超时阈值
   调大初始化状态传输的超时时间，避免因网络延迟或缓存数据量较大导致超时：

confBuilder.clustering().stateTransfer()
    .timeout(30, TimeUnit.SECONDS); // 默认10秒，可根据实际场景调整

2. 设置缓存懒加载
   将缓存初始化改为首次使用时触发，降低应用启动阶段对集群状态的依赖：

@Bean
public Cache pairExecutionsCache() {
    CacheConfiguration config = confBuilder.build();
    // 第三个参数true表示懒加载缓存
    return cacheManager.getCache("pair-executions-cache", config, true);
}

3. 排查网络连通性

• 确认集群节点间的JGroups默认端口（7800）可互相访问
• 检查防火墙、K8s NetworkPolicy等是否限制了节点间的通信

三、验证步骤 #

• 启动节点后，查看日志中是否存在ISPN000094: Received new cluster view记录，确认集群组网成功
• 在一个节点写入缓存条目，通过另一个节点的业务接口或日志验证数据是否同步
• 借助Infinispan控制台或JMX工具，查看缓存的集群节点列表，确认所有节点已加入集群

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