Ignite缓存存储自定义对象列表时出现ClassNotFoundException问题咨询

问题概述 #

我使用非持久化Ignite缓存，键类型为java.lang.String，自定义Transaction类作为值类型时，直接存储单个对象能正常运行；但将值类型改为List<Transaction>时，服务器端会触发ClassNotFoundException。目前已通过将Transaction类文件复制到Ignite安装目录的bin/libs目录解决问题，但想明白两种场景的差异，以及其他可行方案。

自定义Transaction类代码：

public class Transaction {
    private int counter;

    public Transaction(int counter) {
        this.counter = counter;
    }

    public String toString() {
        return String.valueOf(counter);
    }
}

差异原因 #

核心在于Ignite对等类加载（Peer Class Loading）的触发逻辑：

• 存储单个Transaction对象时，缓存的value类型明确为Transaction，Ignite在序列化过程中会直接识别到这个自定义类型，自动通过对等类加载机制将Transaction的类文件从客户端传输到服务器端，服务器能正常加载类并反序列化对象。
• 存储List<Transaction>时，由于Java的类型擦除，运行时实际处理的是ArrayList（Arrays.asList返回的实现类），泛型参数Transaction在编译后会被擦除为Object。服务器端反序列化ArrayList时，只会优先加载ArrayList本身的类，当尝试将列表中的元素转换为Transaction时，才发现缺少对应的类定义，但此时对等类加载的触发时机已过——Ignite没有在序列化阶段检测到泛型中隐藏的Transaction依赖，导致无法自动传输类文件，最终抛出ClassNotFoundException。

其他解决方案 #

除了将类文件复制到服务器类路径外，还有以下几种可行方案：

1. 显式注册自定义类到Binary序列化配置 #

通过Ignite的BinaryConfiguration将Transaction类加入序列化白名单，让Ignite主动识别并加载该类，不管是单个对象还是泛型容器场景都能触发对等类加载：

IgniteConfiguration cfg = new IgniteConfiguration();
// 其他配置（客户端模式、发现SPI等）保持不变

BinaryConfiguration binaryCfg = new BinaryConfiguration();
binaryCfg.setClassNames(Collections.singletonList(Transaction.class.getName()));
cfg.setBinaryConfiguration(binaryCfg);

Ignite ignite = Ignition.start(cfg);

2. 使用BinaryObject包装泛型列表 #

将Transaction对象转换为Ignite的BinaryObject，再存入列表，这样Ignite能明确识别到对象的类型信息，触发对等类加载：

IgniteCache<String, List<BinaryObject>> cache = ignite.getOrCreateCache("blocked");

BinaryObject txBinary = ignite.binary().toBinary(new Transaction(100));
cache.put("c1234_t2345_p3456", Collections.singletonList(txBinary));

3. 打包自定义类为JAR，通过启动参数指定类路径 #

将Transaction类打包成JAR文件，在启动Ignite服务器时通过-cp参数指定该JAR的路径，避免手动复制文件到libs目录：

./ignite.sh -cp /path/to/your/transaction.jar

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