IDEA 运行 Junit 测试用例报 !!! JUnit version 3.8 or later expected 错误

问题介绍

在使用 IDEA 运行 Junit 测试用例的时候，控制台报了!!! JUnit version 3.8 or later expected错误，完整报错信息如下：

!!! JUnit version 3.8 or later expected:

java.lang.ClassNotFoundException: junit.framework.ComparisonFailure
	at java.net.URLClassLoader.findClass(URLClassLoader.java:382)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:418)
	at sun.misc.Launcher$AppClassLoader.loadClass(Launcher.java:352)
	at java.lang.ClassLoader.loadClass(ClassLoader.java:351)
	at java.lang.Class.forName0(Native Method)
	at java.lang.Class.forName(Class.java:264)
	at com.intellij.rt.junit.JUnitStarter.junitVersionChecks(JUnitStarter.java:209)
	at com.intellij.rt.junit.JUnitStarter.canWorkWithJUnitVersion(JUnitStarter.java:195)
	at com.intellij.rt.junit.JUnitStarter.main(JUnitStarter.java:49)

我的测试代码

import org.junit.jupiter.api.Test;

public class StronglyReferenceTest {

    @Test
    public void test() {
        System.out.println("hello");
    }

}

问题排查

看到ClassNotFoundException第一反应就是包冲突，所以先排查项目的依赖，看是否有依赖冲突。查看了pom文件，项目关于junit的依赖只有：

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter</artifactId>
    <version>5.7.1</version>
    <scope>test</scope>
</dependency>

显然这并不会导致包冲突，而且当我使用mvn clean test命令去执行测试用例的时候，测试用例能正常执行

$ mvn clean test
...

[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 1.736 s
[INFO] Finished at: 2021-03-13T21:01:28+08:00
[INFO] Final Memory: 14M/68M
[INFO] ------------------------------------------------------------------------

这就更加证明了项目代码本身没什么问题，该报错有可能是 IDEA 的 bug，所以去 google 看有没有人遇到相关的问题，查找了一番后，发现遇到该问题的人还不少

搜索到的网站基本都被我浏览了一遍，后面找到一个帖子，这位作者虽然跟我一样的报错，但他是在运行main方法的时候报的错，并不是运行junit测试方法时报的，原文链接为：https://intellij-support.jetbrains.com/hc/en-us/community/posts/360003450980-JUnit-version-3-8-or-later-expected?page=2#comments

他产生该问题的原因是类名使用了Test结尾，而以Test结尾的类，IDEA 会将其识别为 junit 测试类去运行（这是IDEA的bug，不过我用的版本已经修复了）。解决方案就是类名去掉Test后缀

上面的解决方案给了我一点启发，会不会我的错误也是类名问题呢？于是我也去掉Test后缀，即将StronglyReferenceTest改为StronglyReferenc后再次执行测试方法，发现问题解决了，测试方法执行正常

但我的类本来就是一个 junit 测试类啊，为什么以Test结尾也会报错呢？而且我之前的其他项目，类名也是以Test结尾的，也能正常运行

后来发现原来是我之前在src/main/java下也创建了一个StronglyReferenceTest类

当src/main/java文件夹下有与src/test/java文件夹下相同名字的类时，执行该类的测试方法就会报错，解决方案就是尽量避免相同名称的类出现（实际上项目中一般不会出现这种问题）

结论

src 下的类，最好不要以Test结尾，这样做并不规范，而且容易导致编辑器的误解，以为该类是测试类，从而导致意想不到的错误

我也向 IDEA 上报了该问题，等待 IDEA 的回复，感兴趣的同学可以点击该链接围观：https://youtrack.jetbrains.com/issue/IDEA-264240

最后，如果该文章对你有帮助的话，可以在微信搜索huangxy关注我的公众号，也可以扫下方二维码进行关注