JUnit测试IDE运行正常但mvn test报错的问题排查与解决

我开发了一个插件项目，同时搭建了PluginTest项目存放JUnit测试用例，将插件项目作为依赖引入测试项目。在IDE中通过Run As > JUnit Test运行测试完全正常，但执行mvn test命令（无论是命令行还是IDE内）时，出现如下错误：

[ERROR] com.advantest.kohai.test.utils.MetricsTest.test7WriteCsv  Time elapsed: 0 s  <<< ERROR!
java.lang.NoClassDefFoundError: Could not initialize class com.advantest.kohai.utils.Logger

测试项目的POM文件如下：

<project xmlns="http://maven.apache.org/POM/4.0.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <groupId>kohaiTest</groupId>
    <artifactId>kohaiTest</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>Kohai Test</name>
    <repositories>
        <repository>
            <id>central</id>
            <url>https://repo.maven.apache.org/maven2</url>
        </repository>
        <repository>
            <id>eclipse-p2</id>
            <url>https://download.eclipse.org/releases/latest</url>
        </repository>
    </repositories>

    <build>
    <sourceDirectory>src</sourceDirectory>
    <testSourceDirectory>src/com/advantest/kohai</testSourceDirectory>
    <plugins>
        <plugin>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
                <source>17</source>
                <target>17</target>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.jacoco</groupId>
            <artifactId>jacoco-maven-plugin</artifactId>
            <version>0.8.11</version>
            <executions>
                <execution>
                    <goals>
                        <goal>prepare-agent</goal>
                    </goals>
                </execution>
                <execution>
                    <id>report</id>
                    <phase>test</phase>
                    <goals>
                        <goal>report</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        <!-- Add the Surefire Plugin configuration -->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.0.0-M5</version> <!-- Use the latest version -->
            <configuration>
                <!-- Add any necessary configurations -->
            </configuration>
        </plugin>
    </plugins>
</build>

    <properties>
        <osgi.platform>linux</osgi.platform>
    </properties>
    <dependencies>
        <dependency>
            <groupId>junit</groupId>
            <artifactId>junit</artifactId>
            <version>4.12</version>

        </dependency>
        <!-- https://mvnrepository.com/artifact/net.bytebuddy/byte-buddy -->
        <dependency>
            <groupId>net.bytebuddy</groupId>
            <artifactId>byte-buddy</artifactId>
            <version>1.14.10</version>
        </dependency>

        <dependency>
            <groupId>org.mockito</groupId>
            <artifactId>mockito-core</artifactId>
            <version>5.6.0</version>
        </dependency>
        <dependency>
            <groupId>com.opencsv</groupId>
            <artifactId>opencsv</artifactId>
            <version>5.9</version>
        </dependency>
        <dependency>
            <groupId>org.eclipse.core</groupId>
            <artifactId>org.eclipse.core.runtime</artifactId>
            <version>3.7.0</version>
        </dependency>
        <dependency>
            <groupId>org.eclipse.platform</groupId>
            <artifactId>org.eclipse.ui</artifactId>
            <version>3.205.0</version>
        </dependency>
        <dependency>
            <groupId>xml-apis</groupId>
            <artifactId>xml-apis-ext</artifactId>
            <version>1.3.04</version>
        </dependency>
        <dependency>
            <groupId>org.eclipse.platform</groupId>
            <artifactId>org.eclipse.swt.gtk.linux.aarch64</artifactId>
            <version>3.124.200</version>
        </dependency>


        <dependency>
            <groupId>com.advantest.kohai</groupId>
            <artifactId>com.advantest.kohai.plugin</artifactId>
            <version>0.0.1-SNAPSHOT</version>
        </dependency>
    </dependencies>
</project>

仅Logger类出现该报错，IDE中运行JUnit测试无问题。请问两种运行方式的差异是什么，该如何修复？

两种运行方式的核心差异 #

• 类路径构建逻辑不同：IDE运行JUnit时，会自动识别项目依赖（包括插件项目的编译输出目录）并加入类路径；而Maven的test命令严格按POM声明的依赖构建类路径，若插件项目未安装到本地仓库，Maven无法找到其编译后的class文件。
• 环境初始化差异：IDE可能自动加载Eclipse插件环境的上下文（如OSGi相关配置），但Maven默认是标准Java环境，缺少OSGi容器初始化逻辑，若Logger类依赖OSGi服务（如BundleContext），在Maven环境中无法初始化。
• 测试目录配置差异：你的POM中testSourceDirectory设置为src/com/advantest/kohai，不符合Maven标准目录结构（标准应为src/test/java），可能导致Maven未正确识别测试类或加载所需资源。

修复方案 #

1. 确保插件项目已安装到本地Maven仓库 #

在插件项目根目录执行：

mvn clean install

让测试项目的Maven依赖能正确拉取到插件项目的编译产物。

2. 修正Maven测试目录结构 #

将POM中的testSourceDirectory改为标准路径：

<testSourceDirectory>src/test/java</testSourceDirectory>

同时将测试类移动到src/test/java/com/advantest/kohai目录下，遵循Maven约定优于配置的原则，避免类路径加载异常。

3. 处理Logger类的OSGi依赖问题 #

如果Logger类依赖OSGi容器服务（比如通过Activator获取BundleContext），在Maven的JUnit测试环境中需要模拟或提供这些依赖：

• 使用Mockito模拟BundleContext或相关OSGi服务，注入到Logger类中；
• 为测试项目添加OSGi测试框架依赖（如org.eclipse.equinox.launcher），在测试启动时初始化简易OSGi容器；
• 修改Logger类，使其在非OSGi环境下有降级初始化逻辑（比如使用普通Java日志框架替代）。

4. 检查Surefire插件配置 #

确保Surefire插件能正确加载所有依赖，可添加配置强制包含插件项目的依赖：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.0.0-M5</version>
    <configuration>
        <useSystemClassLoader>true</useSystemClassLoader>
    </configuration>
</plugin>

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