启用持久化升级Apache Ignite 2.16时遇错误求助

问题核心 #

升级至Ignite 2.16并启用persistence=true后，执行SQL查询抛出BinaryObjectException，提示无法找到compact footer对象的元数据；禁用持久化或使用2.16以下版本时无此问题。

修复方案 #

1. 清理并重新初始化持久化存储（需备份数据） #

• 停止所有Ignite节点
• 备份IGNITE_HOME/work目录（包含持久化数据和元数据）
• 删除work/db和work/metadata下的所有文件
• 重启节点，让Ignite重新创建持久化存储结构

2. 调整二进制元数据配置 #

在Ignite配置中显式配置二进制类型的存储策略，避免元数据丢失：

XML配置示例

<bean class="org.apache.ignite.configuration.IgniteConfiguration">
    <!-- 其他核心配置 -->
    <property name="binaryConfiguration">
        <bean class="org.apache.ignite.configuration.BinaryConfiguration">
            <!-- 禁用compact footer，确保元数据完整存储 -->
            <property name="compactFooter" value="false"/>
            <!-- 强制元数据持久化到磁盘 -->
            <property name="metadataStorageConfiguration">
                <bean class="org.apache.ignite.configuration.MetadataStorageConfiguration">
                    <property name="type" value="PERSISTENT"/>
                </bean>
            </property>
        </bean>
    </property>
</bean>

Java代码配置示例

IgniteConfiguration igniteCfg = new IgniteConfiguration();

BinaryConfiguration binaryCfg = new BinaryConfiguration();
// 禁用compact footer
binaryCfg.setCompactFooter(false);

MetadataStorageConfiguration metaCfg = new MetadataStorageConfiguration();
// 设置元数据持久化到磁盘
metaCfg.setType(MetadataStorageType.PERSISTENT);

binaryCfg.setMetadataStorageConfiguration(metaCfg);
igniteCfg.setBinaryConfiguration(binaryCfg);

3. 确保Spring Data与Ignite版本兼容 #

当前使用的ignite-spring-data-ext-2.0.0.jar需与Ignite 2.16版本匹配。建议升级到对应版本的Spring Data扩展包，避免版本不兼容导致的元数据处理异常。

4. 提前加载实体类 #

在节点启动时，确保所有需要持久化的实体类被提前加载（例如在启动类中显式引用，或配置包扫描），让Ignite在启动阶段完成元数据注册，避免查询时元数据缺失。

方案说明 #

• 禁用compactFooter：2.16版本中compact footer模式可能导致元数据未完整写入持久化存储，禁用后使用完整元数据格式，保证磁盘存储的元数据可被正确加载。
• 强制元数据持久化：默认配置下元数据可能仅存于内存，启用持久化后需显式配置让元数据写入磁盘，重启节点后可恢复。
• 清理旧存储：升级过程中旧版本的持久化数据与2.16的元数据格式不兼容，清理后重新初始化可消除版本冲突。

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