Apache Ignite中使用deploymentSpi动态加载数据过滤类失败排查

核心结论 #

Ignite的对等类加载（Peer Class Loading）和UriDeploymentSpi并非仅适用于Tasks，完全支持查询过滤器类的动态加载，你的问题大概率是配置细节或类加载兼容性问题导致的。

具体排查方向 #

1. 修正UriDeploymentSpi的URI路径配置 #

你的配置中使用了file:////C:/Users/toby/myproject/build/libs，Windows系统下的file URI格式应为三个斜杠（file:///C:/...），多余的斜杠可能导致服务器无法正确解析目录路径，进而无法监控jar变化。修改后的配置片段：

<property name="uriList">
    <list>
        <value>file:///C:/Users/toby/myproject/build/libs</value>
    </list>
</property>

同时建议显式配置扫描间隔，避免依赖默认值：

<bean class="org.apache.ignite.spi.deployment.uri.UriDeploymentSpi">
    <property name="temporaryDirectoryPath" value="C:\Temp"/>
    <property name="scanFrequency" value="5000"/> <!-- 5秒扫描一次 -->
    <property name="uriList">
        <list>
            <value>file:///C:/Users/toby/myproject/build/libs</value>
        </list>
    </property>
</bean>

2. 检查权限与目录可访问性 #

• 确保Ignite服务器进程对C:/Users/toby/myproject/build/libs有读取权限，对C:\Temp有读写权限，否则无法复制或刷新jar文件。
• 确认目标目录下的jar包是完整的，包含DataFilter和DataObject的类文件，且jar包未被其他进程锁定。

3. 对齐Scala库版本 #

Scala的类加载对版本非常敏感，服务器端libs目录中的Scala库版本必须与客户端编译时使用的版本完全一致，否则即使类名相同，也会因类结构不兼容抛出ClassNotFoundException。

4. 验证类序列化与传递 #

• 确保DataFilter类显式实现Serializable（Scala case类默认支持，但自定义类需注意），且所有依赖类型（如Option[UUID]）在服务器端类路径中存在。
• 瘦客户端发送过滤器实例时，需要确保序列化后的类信息能被服务器识别，建议在客户端代码中显式指定类的序列化方式（如使用Scala默认序列化或Ignite的优化序列化）。

5. 调整类加载器配置 #

如果遇到类加载隔离问题（类似IGNITE-18146的场景），可以尝试在Ignite启动脚本中添加JVM参数，强制使用应用类加载器加载部署的jar：

# Windows启动脚本（ignite.bat）中添加
set IGNITE_JVM_OPTS=-Dignite.use.system.classloader=false %IGNITE_JVM_OPTS%

6. 验证部署状态 #

• 查看Ignite服务器日志，搜索UriDeploymentSpi关键词，确认是否输出"Deployed jar from URI"之类的成功日志，以及是否检测到jar的更新。
• 使用Ignitevisor工具连接服务器，执行deploy -list命令，检查DataFilter类是否已被成功部署。

补充测试步骤 #

1. 重启Ignite服务器，确认日志中显示UriDeploymentSpi已加载目标目录的jar。
2. 修改DataFilter类，重新编译生成jar包，替换到C:/Users/toby/myproject/build/libs目录。
3. 等待5秒以上，查看C:\Temp下的临时目录是否更新了新的jar。
4. 执行带过滤器的ScanQuery，观察是否还抛出异常。

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