Spring Boot 3.1.4升级后JUnit 5.10.0出现NoSuchMethodError求助

问题根源 #

java.lang.NoSuchMethodError: org.junit.platform.commons.util.ClassLoaderUtils.getClassLoader(java.lang.Class) 错误本质是JUnit Platform Commons组件版本不兼容——旧版本的该组件不存在这个方法，但你的测试代码或依赖库需要调用它。通常是依赖传递引入了低版本的JUnit Platform Commons，和你指定的JUnit 5.10.0版本不匹配。

解决方案 #

1. 依赖版本统一：用Spring Boot的依赖管理 #

Spring Boot的spring-boot-starter-test已经内置了兼容的JUnit 5、Mockito、Commons IO等版本，完全不需要手动指定这些依赖的版本号，这是避免版本冲突的最佳方式。

• 移除pom.xml（或build.gradle）中手动指定的junit-jupiter、mockito-core、commons-io等依赖的版本号。
• 确保测试依赖只保留spring-boot-starter-test，Maven示例配置：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>

2. 排查并排除冲突依赖 #

如果必须手动引入某些依赖导致冲突，先排查依赖树找到低版本的junit-platform-commons：

• Maven执行命令：

mvn dependency:tree | grep junit-platform-commons

• 找到引入低版本的依赖后，添加排除配置，示例：

<dependency>
    <groupId>[冲突依赖的groupId]</groupId>
    <artifactId>[冲突依赖的artifactId]</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-commons</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 检查参数化测试注解配置 #

升级后JUnit 5的参数化测试有细节调整，确保代码使用正确的注解：

• 测试方法必须标注@ParameterizedTest，搭配正确的数据源注解（如@ValueSource、@CsvSource）。
• 不要混用JUnit 4和JUnit 5的注解（比如不要同时用org.junit.Test和org.junit.jupiter.api.Test）。

4. 清理构建缓存 #

• 执行清理构建命令，刷新依赖：

# Maven
mvn clean install -U
# Gradle
./gradlew clean build --refresh-dependencies

• 重启IDE并清除缓存（比如IntelliJ IDEA选择File -> Invalidate Caches...），避免IDE加载旧版本的类文件。

验证 #

重新运行参数化测试，确认错误消失，测试正常执行。

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