IntelliJ如何判定Groovy类为测试类？测试运行异常求助

一、类与方法的标识规则 #

• 类需满足以下任一条件：
  • 继承测试框架核心类，比如Spock的Specification，会直接被判定为测试类；
  • 类上带有测试框架的类级注解，比如JUnit的@RunWith、JUnit 5的@TestInstance；
  • 类中存在至少一个带测试注解的方法，比如JUnit的@Test、Spock的无注解但符合规范的测试方法（以def定义、方法名带should等约定或用@Unroll注解）。
• 测试方法需符合框架规范：
  • 方法访问修饰符为public或Groovy默认的包私有（非私有修饰符更稳妥）；
  • 注解必须是对应测试框架的官方类，比如org.junit.Test而非自定义的同名注解，IDE会校验注解全类名。

二、项目配置要求 #

• 测试类所在目录必须被标记为Test Sources Root（IDE中显示为蓝色目录），非测试根目录下的类即便有测试注解也不会被识别。
• 项目已正确配置Groovy SDK，且测试框架（JUnit/Spock等）的依赖已被IDE识别，依赖的Scope需设置为Test。

三、索引与缓存影响 #

IDE的索引和缓存文件损坏或不一致时，会出现符合规则但不显示运行箭头的情况——这就是你遇到重建项目有时有效、需git clean重置的原因。

针对你遇到的不稳定问题的快速排查点 #

• 检查异常测试类的目录是否为Test Sources Root，右键目录→Mark Directory as→Test Sources Root；
• 打开File→Project Structure→Modules→Dependencies，确认Groovy SDK和测试框架依赖已正确添加且Scope为Test；
• 优先用File→Invalidate Caches...→Invalidate and Restart强制重建索引，比git clean更温和；
• 检查测试类/方法的注解是否误导入了非官方的同名类。

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