JUnit5 @Suite注解测试无法被IDEA识别执行问题求助

你遇到的是IDEA对JUnit5套件注解的识别适配问题，以下是几个实用的排查和解决步骤：

• 核对依赖与IDEA同步状态
  确保项目依赖已正确引入JUnit5套件所需的API和引擎包，且IDEA已同步这些依赖。如果是Maven项目，右键项目选择Maven > Reload Project，再通过File > Project Structure > Libraries确认junit-platform-suite-api和junit-platform-suite-engine存在且版本统一。

• 手动创建正确的JUnit运行配置
  IDEA自动生成的套件运行配置可能存在问题，手动配置试试：

  1. 点击顶部运行栏的Edit Configurations
  2. 点击+号选择JUnit
  3. 在Test kind中选择Suite，Suite class指定你的自定义套件类（比如com.yourpackage.CustomSuite）
  4. 确认JDK配置与项目一致，保存配置后再运行。

• 检查@Suite注解的写法
  套件类的注解必须完整，比如要搭配@SelectClasses指定测试类，同时测试类要使用JUnit5的@Test注解（org.junit.jupiter.api.Test），避免使用JUnit4的旧注解。示例代码：

  import org.junit.platform.suite.api.SelectClasses;
  import org.junit.platform.suite.api.Suite;
  
  @Suite
  @SelectClasses({SimpleTest.class})
  public class CustomSuite {
  }
  

• 调整IDEA的测试相关设置

  1. 打开File > Settings > Build, Execution, Deployment > Testing > JUnit，确认默认测试运行器为JUnit5。
  2. 如果之前开启了Delegate IDE build/run actions to Maven，前往File > Settings > Build, Execution, Deployment > Build Tools > Maven > Runner取消勾选，重启IDEA后再尝试运行。

• 清理IDEA缓存
  缓存异常可能导致测试识别错误，执行File > Invalidate Caches...，选择Invalidate and Restart，清理后重启IDE再尝试运行套件。

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