Ignite配置Log4J日志报错：类路径缺失问题排查与解决

报错原因 #

核心问题是类路径缺失Log4J日志依赖包：Ignite的Log4J日志实现模块（ignite-log4j）属于可选组件，默认不会自动加入类路径。你在default-config.xml中配置了org.apache.ignite.logger.log4j.Log4JLogger，但JVM找不到该类对应的jar包，直接导致Spring容器初始化失败。

查看你的bashrc配置，虽然已编写USER_LIBS指向ignite-log4j-2.11.0.jar的配置，但该配置被注释未启用，因此依赖未被加载。

解决步骤 #

1. 启用USER_LIBS环境变量
   编辑~/.bashrc文件，取消注释并正确配置USER_LIBS：

   export USER_LIBS=$IGNITE_HOME/libs/optional/ignite-log4j/ignite-log4j-2.11.0.jar
   

   若需加载多个可选依赖，用冒号分隔路径即可。

2. 刷新环境变量
   执行命令让修改立即生效：

   source ~/.bashrc
   

3. 确认Log4J配置文件路径正确
   检查log4j-config.xml的位置：

   • 用相对路径时，需放在Ignite启动的工作目录（如apache-ignite-2.11.0-bin根目录）；
   • 稳妥起见可直接用绝对路径，示例：

     <constructor-arg type="java.lang.String" value="/home/a/apache-ignite-2.11.0-bin/config/log4j-config.xml"/>
     

4. 重新启动Ignite
   再次运行启动命令：

   ./ignite.sh
   

额外说明 #

启动时出现的反射访问警告是Ignite与高版本JDK的兼容提示，不影响核心功能，可直接忽略；若在意该提示，启动时添加--illegal-access=warn参数即可，但这并非本次报错的根源。

内容的提问来源于stack exchange，提问作者김남욱