开发Neo4j插件集成Elasticsearch时遇log4j类找不到异常

从你贴的错误栈来看，核心问题是java.lang.NoClassDefFoundError: Lorg/apache/log4j/Logger;——简单说就是Neo4j加载你的插件时，找不到org.apache.log4j.Logger这个类，或者类加载环境因为依赖冲突乱套了。结合你的POM配置和提到的commons-logging冲突，根源主要有两点：

1. 日志框架的类加载隔离问题：Neo4j自身用的是SLF4J+Logback这套日志体系，而你直接给插件引入了log4j 1.2.17，两者在类加载层面不兼容——要么Neo4j的类加载器读不到插件打包的log4j类，要么加载了冲突版本导致类定义异常。
2. commons-logging版本冲突：你用的Elasticsearch Transport客户端（6.2.4版本）依赖的commons-logging，和Neo4j内置的版本不一致，这种版本冲突会间接引发日志类的加载失败。

1. 替换日志依赖，用桥接包适配Neo4j的日志体系 #

别直接引入log4j了，换成SLF4J的桥接包，让插件的日志调用自动适配Neo4j的日志环境：

• 先删掉POM里直接的log4j依赖
• 给Elasticsearch依赖排除自带的commons-logging和log4j，再添加log4j-over-slf4j桥接包

修改后的POM片段：

<dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>transport</artifactId>
    <version>6.2.4</version>
    <!-- 排除Elasticsearch自带的冲突依赖 -->
    <exclusions>
        <exclusion>
            <groupId>commons-logging</groupId>
            <artifactId>commons-logging</artifactId>
        </exclusion>
        <exclusion>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<!-- 把log4j的日志调用桥接到SLF4J，适配Neo4j的日志系统 -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>log4j-over-slf4j</artifactId>
    <version>1.7.30</version> <!-- 选和Neo4j兼容的版本，Neo4j 3.x一般用1.7.x系列 -->
    <scope>runtime</scope>
</dependency>

2. 解决commons-logging的冲突问题 #

给插件加上jcl-over-slf4j，把commons-logging的调用也桥接到SLF4J，彻底避免版本冲突：

<!-- 桥接commons-logging到SLF4J，消除版本冲突 -->
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>jcl-over-slf4j</artifactId>
    <version>1.7.30</version>
    <scope>runtime</scope>
</dependency>

3. 用Shade插件隔离依赖（可选但推荐） #

如果上面的方法还是没解决冲突，可以用Maven Shade插件把插件的依赖重命名，完全隔离插件和Neo4j的内置依赖：
在POM的<build>节点下添加这个插件配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.2.4</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <relocations>
                            <!-- 重命名log4j相关包，避免和Neo4j冲突 -->
                            <relocation>
                                <pattern>org.apache.log4j</pattern>
                                <shadedPattern>你的插件包名.shaded.org.apache.log4j</shadedPattern>
                            </relocation>
                            <!-- 重命名commons-logging包 -->
                            <relocation>
                                <pattern>org.apache.commons.logging</pattern>
                                <shadedPattern>你的插件包名.shaded.org.apache.commons.logging</shadedPattern>
                            </relocation>
                        </relocations>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

记得把你的插件包名换成你实际的插件根包名，比如com.yourcompany.neo4j.elasticsearch。

4. 验证依赖树 #

执行mvn dependency:tree命令，检查输出里有没有残留的log4j 1.2.17和冲突的commons-logging版本，确保所有日志相关依赖都被桥接或者重命名了。

1. 重新打包插件，替换Neo4j插件目录里的旧JAR文件
2. 启动Neo4j，查看日志是否还有NoClassDefFoundError的报错
3. 如果还是有问题，先暂时移除Neo4j插件目录里的其他插件，排除其他插件带来的依赖冲突

内容的提问来源于stack exchange，提问作者Darshil Babel