Infinispan+Hibernate二级缓存+JGroups启动节点时出现ReadWriteKeyCommand错误

一、锁超时设为0毫秒的原因 #

Infinispan 10+版本引入了节点集群加入阶段的状态管控逻辑：当节点处于JOINING状态（未完成集群加入和全量状态同步）时，针对该节点的缓存锁请求会被强制设置超时为0毫秒。这是新版本的防护机制，避免未就绪节点处理锁请求导致集群数据不一致，但你的场景中主节点在从节点未就绪时就发起了缓存复制命令，触发了这个超时。

二、可能遗漏的配置项（针对Infinispan 8→13的版本变化） #

1. 调整状态转移等待配置 #

在Infinispan缓存配置中，确保从节点完成状态转移后再处理业务请求，添加或修改initial-state-transfer参数：

<cache-container ...>
  <cache name="clientDeviceNotificationTimeRangeCache" ...>
    <clustering>
      <state-transfer await-initial-transfer="true" timeout="60000"/>
    </clustering>
  </cache>
</cache-container>

• await-initial-transfer="true"：强制节点等待全量状态转移完成后再启动缓存服务
• timeout="60000"：设置状态转移超时为60秒，避免因网络延迟导致同步中断

2. 显式配置缓存锁超时 #

在缓存的locking模块设置非0的锁获取超时，覆盖默认的0值：

<cache name="clientDeviceNotificationTimeRangeCache" ...>
  <locking acquire-timeout="30000" concurrency-level="100"/>
</cache>

• acquire-timeout="30000"：设置锁获取超时为30秒，给从节点足够时间处理锁请求

3. 验证复合主键的序列化 #

你的缓存键是自定义复合主键ClientDeviceNotificationTimeRangePrimaryKey，需确保：

• 该类实现java.io.Serializable接口
• 若使用ProtoStream序列化（Infinispan 10+默认推荐），需为该类添加序列化注解或配置文件，确保状态转移时对象能正确序列化/反序列化，避免因对象丢失引发NoSuchElementException

4. 对齐Hibernate与Infinispan的集群模式 #

在Hibernate配置中显式指定缓存的集群模式，确保与Infinispan配置匹配：

hibernate.cache.infinispan.clientDeviceNotificationTimeRangeCache.clustering_mode=REPLICATION
hibernate.cache.infinispan.clientDeviceNotificationTimeRangeCache.sync=true

• 明确指定复制模式（REPLICATION）和同步模式，避免默认模式不匹配导致的复制异常

5. 延迟缓存初始化时机 #

避免应用启动阶段直接触发缓存写入，添加Hibernate配置延迟缓存初始化：

hibernate.cache.bootstrap_delay=5000

• 让缓存延迟5秒初始化，给从节点足够时间完成集群加入流程

三、额外检查点 #

• 确认JGroups配置文件（如jgroups.xml）中的节点发现协议（TCPPING/MPING）配置正确，确保节点能互相发现并建立集群连接
• 开启org.infinispan的DEBUG级日志，查看状态转移的详细过程，定位是否存在同步失败的具体细节

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