解决 JUnit NoSuchMethodError 报错：Spring Boot 版本兼容性排查

修复 JUnit NoSuchMethodError 异常

最近在项目初始化后运行测试时，遇到了一个典型的 NoSuchMethodError 报错。堆栈信息显示是在 IntelliJ IDEA 内部调用 JUnit 5 相关工具类时发生的。

错误现象

控制台抛出了如下异常：

Exception in thread "main" java.lang.NoSuchMethodError: 'java.lang.String org.junit.platform.engine.discovery.MethodSelector.getMethodParameterTypes()'
    at com.intellij.junit5.JUnit5TestRunnerUtil.loadMethodByReflection(JUnit5TestRunnerUtil.java:127)
    ...

原因分析

这个错误本质上反映了运行时环境与编译时依赖之间的版本错位。具体来说，JVM 试图调用 org.junit.platform.engine.discovery.MethodSelector 类中的 getMethodParameterTypes() 方法，但当前 classpath 下加载的 MethodSelector 实现类里根本没有这个方法。

这种情况在 Spring Boot 项目中非常常见，通常是因为 spring-boot-starter-parent 管理的 JUnit 版本与你实际引入的 JUnit 版本不一致，或者 IDEA 缓存了旧的依赖。

解决方案

最直接的办法是统一父工程版本，让 Spring Boot 帮你管理好依赖树。请检查你的 pom.xml，将 spring-boot-starter-parent 的版本号调整为已知兼容的版本，例如 2.7.17。

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.17</version>
    <relativePath/>
</parent>

修改完成后，记得刷新 Maven 依赖并重启 IDEA。如果问题依旧，可以尝试执行 mvn clean 清除本地缓存后再试。

避坑指南

1. 不要手动指定 JUnit 版本：除非你有特殊需求，否则尽量让 Spring Boot 的 BOM 来管理 junit-jupiter 和 junit-platform 的版本，避免冲突。
2. 清理缓存：有时候 IDE 的索引会残留旧文件，File -> Invalidate Caches / Restart 往往能解决莫名其妙的类找不到问题。