Apache Ignite 2.12运行数天后无法连接查询缓存问题求助

问题原因 #

日志中的Getting affinity for too old topology version that is already out of history错误，本质是节点尝试使用的拓扑版本（topVer=24）已被清理出节点保留的拓扑历史缓存。Ignite默认仅保留最近16个拓扑版本记录，当集群频繁发生拓扑变更（节点上下线、缓存增删），旧版本会被淘汰；若存在慢查询、长时运行任务或节点同步延迟，就会出现引用过期拓扑版本的情况。

根本解决方案 #

1. 扩大拓扑历史保留长度 #

Ignite默认通过affinityHistorySize参数控制保留的拓扑版本数量（默认值16），可根据集群拓扑变更频率调大该值：

• XML配置：

  <bean class="org.apache.ignite.configuration.IgniteConfiguration">
      <property name="affinityHistorySize" value="64"/>
  </bean>
  

• Java代码配置：

  IgniteConfiguration cfg = new IgniteConfiguration();
  cfg.setAffinityHistorySize(64);
  

• K8s环境变量配置：

  IGNITE_AFFINITY_HISTORY_SIZE=64
  

  建议根据实际拓扑变更频率调整，比如集群每天有几次变更，设置为32或64即可满足需求。

2. 减少不必要的拓扑变更 #

• 优化K8s Pod的存活/就绪探针配置，避免因探针阈值过严导致Pod频繁重启；调整调度策略，减少节点漂移引发的拓扑变更。
• 避免频繁创建或销毁缓存，提前规划缓存结构，复用已有缓存实例，减少拓扑触发事件。

3. 优化查询与任务执行 #

• 排查并优化慢查询：添加合适的索引，缩小数据扫描范围，避免长时间持有旧拓扑上下文。
• 拆分长时运行的分布式任务：将大任务拆分为多个短任务，降低任务执行期间拓扑版本过期的概率。

4. 升级Ignite版本 #

Ignite 2.12属于较早版本，后续2.13及以上版本对拓扑历史管理、异常恢复逻辑做了优化，升级至最新稳定版可规避此类已知问题。

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