使用example-igfs.xml启动Ignite节点时遭遇NoClassDefFoundError错误

这个问题我之前在配置Ignite作为HDFS缓存层时也踩过坑，本质是缺少Guava依赖导致的类加载失败。下面给你拆解原因和具体解决办法：

错误原因分析 #

java.lang.NoClassDefFoundError提示找不到com.google.common.base.Preconditions类，这个类是Guava（Google的核心工具库）的核心类。从错误栈能看到，Hadoop的Configuration类初始化时会用到这个类，而Ignite集成HDFS缓存层时依赖Hadoop组件，一旦类路径里没有Guava，就会触发这个错误。

具体解决步骤 #

1. 使用Ignite官方启动脚本的情况 #

• 先检查Ignite安装目录下的libs/optional/hadoop文件夹，确认里面是否存在guava-*.jar文件。如果没有，需要下载与你的Hadoop版本匹配的Guava包（比如Hadoop 2.x通常适配guava-11.0.2或更高版本），将其放入该目录。
• 或者直接在启动命令中手动添加Guava到类路径：

  ./ignite.sh example-igfs.xml -cp "/path/to/your/guava-xxx.jar"
  

2. 使用Maven/Gradle构建项目的情况 #

直接在项目依赖中添加Guava：

Maven

<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>19.0</version> <!-- 请匹配你的Hadoop版本，避免冲突 -->
</dependency>

Gradle

implementation 'com.google.guava:guava:19.0'

3. 额外注意事项 #

• 确保Hadoop的相关依赖包也已正确加入Ignite的类路径，因为IGFS作为HDFS缓存层需要和HDFS集群交互，缺少Hadoop核心包也会引发其他类加载问题。
• 检查Ignite与Hadoop的版本兼容性：比如Ignite 2.x系列通常兼容Hadoop 2.x版本，尽量避免跨大版本搭配，防止依赖冲突。

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