Java9/10模块模式下SureFire forkCount>0时SpringRunner初始化失败致测试报错

问题背景 #

你遇到的是典型的Java 9+模块系统与Maven SureFire插件fork模式不兼容导致的类加载失败问题，具体表现为：

• 当maven-surefire-plugin的forkCount配置大于0时，测试执行抛出NoClassDefFoundError；
• 在你提供的特定环境（Java 10、Spring Boot 2.0.1.RELEASE、SureFire 2.21.0）下，进一步触发了org.springframework.test.context.junit4.SpringRunner类初始化失败的异常，相关执行日志片段如下：

[INFO] --- maven-surefire-plugin:2.21.0:test (default-test) @ turbo ---
[INFO]
----------...
java.lang.NoClassDefFoundError: Could not initialize class org.springframework.test.context.junit4.SpringRunner

原因剖析 #

这个问题的核心在于：

1. Java 9引入的模块系统（JPMS）改变了类加载的规则，而旧版本的SureFire插件（比如2.21.0）对模块系统的支持存在缺陷；
2. 当SureFire以fork模式运行测试时，子进程无法正确继承父进程的模块路径和类路径配置，导致Spring测试相关的类无法被加载或初始化。

可行解决方案 #

1. 升级SureFire插件到兼容版本 #

这是最推荐的方案，SureFire从2.22.0版本开始专门修复了Java 9+模块系统下fork模式的兼容性问题。修改你的pom.xml配置：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <!-- 推荐使用2.22.2或更高稳定版本 -->
            <version>2.22.2</version>
            <configuration>
                <forkCount>1</forkCount> <!-- 按需设置你的fork数量 -->
            </configuration>
        </plugin>
    </plugins>
</build>

2. 为旧版SureFire添加模块路径配置 #

如果暂时无法升级插件，可以尝试在现有SureFire配置中添加useModulePath参数，强制插件正确处理模块路径：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>2.21.0</version>
    <configuration>
        <forkCount>1</forkCount>
        <useModulePath>true</useModulePath>
    </configuration>
</plugin>

3. 临时禁用fork模式（应急方案） #

如果以上两种方案都无法快速生效，可以临时将forkCount设置为0，让测试在Maven主进程中运行。但注意这会失去fork模式带来的进程隔离优势，不建议长期使用：

<configuration>
    <forkCount>0</forkCount>
</configuration>

验证方法 #

修改配置后，执行mvn clean test重新运行测试，检查控制台输出是否不再出现NoClassDefFoundError，测试用例能否正常执行。

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