Apache Ignite 2.15.0重启启动失败：WAL history过短问题求助

核心原因 #

Windows更新（KB5041580、KB5042352）触发了系统级强制进程终止，导致Ignite的WAL（Write-Ahead Log）写入不完整、WAL归档过程中断，重启时节点校验WAL历史链失败，抛出WAL history is too short错误。

可行解决方案 #

1. 调整Ignite的WAL配置，增强容错性 #

修改Ignite配置文件（或代码配置项），针对单节点场景优化参数：

• 设置walMode为LOG_ONLY，仅记录WAL不依赖归档恢复：

  <property name="walMode" value="LOG_ONLY"/>
  

• 启用walFsyncDelayMs，设置100ms左右的同步延迟，降低系统强制终止时的WAL损坏概率：

  <property name="walFsyncDelayMs" value="100"/>
  

• 关闭WAL归档（单节点无需归档）：

  <property name="walArchivePath" value=""/>
  

2. 配置Ignite优雅关闭机制 #

避免系统更新时强制Kill进程：

• 若Ignite以Windows服务运行，修改服务恢复设置：
  1. 打开服务管理器，找到Ignite服务
  2. 右键→属性→恢复选项卡
  3. 将"第一次失败""第二次失败"设为"重新启动服务"，重启延迟设为30秒
• 在.NET代码中添加进程退出事件处理，主动触发Ignite优雅关闭：

  AppDomain.CurrentDomain.ProcessExit += (sender, e) =>
  {
      Ignite.GetIgnite().Stop(true);
  };
  

3. 修复损坏的WAL历史（无需删除整个存储） #

若需保留缓存数据，可手动修复WAL链：

• 进入Ignite的work/db/wal目录，检查.wal文件命名连续性（格式如00000000000000000001.wal）
• 删除最后几个不完整的WAL文件（通常是系统中断时正在写入的文件）
• 进入wal/archive目录，删除对应缺失的归档文件
• 重启Ignite节点，节点会自动校验剩余WAL并恢复数据

4. 回滚Windows更新（临时应急方案） #

若上述配置调整无效，可临时回滚KB5041580、KB5042352更新，观察问题是否消失，同时等待Ignite官方兼容性补丁。

预防措施 #

• 单节点场景下，若无需持久化缓存数据，可开启persistenceEnabled=false，彻底规避WAL相关问题
• 定期备份Ignite的Cache-Storage目录，避免数据丢失
• 关注Apache Ignite官方更新，及时升级修复Windows兼容性问题的版本

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