访问存储文档时内容库突发Infinispan协议版本不兼容错误

问题背景 #

• 环境：Wildfly服务器部署ModeShape，底层采用Infinispan 6.0.2.Final
• 触发场景：服务器出现内存不足问题，备份日志并释放空间重启后，前端访问已存储文档时出现执行错误
• 错误日志：

ISPN000136: Execution error: org.infinispan.persistence.spi.PersistenceException: java.io.IOException: Unsupported protocol version 0（出自rshalledEntryImpl.java:114 [infinispan-core-6.0.2.Final.jar:6.0.2.Final]）

• 当前状态：存储的文件可见，无明显数据丢失迹象

错误原因 #

内存不足导致Infinispan持久化存储文件写入中断，部分缓存条目文件的头部协议版本标识被破坏（变为0）。重启服务器后，Infinispan加载这些损坏的文件时，因无法识别无效的协议版本，抛出该异常。

恢复方法 #

• 停止Wildfly服务：确保服务器完全停止，防止操作过程中出现数据写入冲突。
• 备份持久化目录：找到ModeShape配置中指定的Infinispan持久化存储路径（通常在Wildfly的standalone/data或自定义目录下），将整个目录复制备份，避免操作失误导致数据丢失。
• 清理损坏的缓存文件：
  1. 进入对应ModeShape缓存的持久化子目录（比如命名为modeshape或匹配缓存名称的文件夹）。
  2. 删除目录下的*.dat或*.entry类数据文件（优先删除内存不足时段修改的文件，若不确定可全部删除这类文件）。注意不要删除*.index等索引或元数据文件，避免破坏文件索引结构。
• 重启Wildfly服务：启动服务器后，Infinispan会重新加载未损坏的持久化数据，并基于ModeShape的文档存储元数据自动重建损坏的缓存条目。
• 验证访问：前端访问存储的文档，确认错误是否消除，数据是否正常加载。

内容的提问来源于stack exchange，提问作者H Sree Harsha