Maven命令行运行JUnit插件测试时junit-jupiter引擎无法发现测试

1. 检查Maven测试插件配置 #

确保maven-surefire-plugin（单元测试）或maven-failsafe-plugin（系统测试）正确绑定JUnit Jupiter引擎，版本需与JUnit Jupiter 5.10.2匹配：

<build>
  <plugins>
    <!-- 单元测试用surefire -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-surefire-plugin</artifactId>
      <version>3.2.5</version>
      <dependencies>
        <dependency>
          <groupId>org.junit.platform</groupId>
          <artifactId>junit-platform-surefire-provider</artifactId>
          <version>1.10.2</version>
        </dependency>
        <dependency>
          <groupId>org.junit.jupiter</groupId>
          <artifactId>junit-jupiter-engine</artifactId>
          <version>5.10.2</version>
        </dependency>
      </dependencies>
    </plugin>
    <!-- 系统测试用failsafe -->
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-failsafe-plugin</artifactId>
      <version>3.2.5</version>
      <executions>
        <execution>
          <goals>
            <goal>integration-test</goal>
            <goal>verify</goal>
          </goals>
        </execution>
      </executions>
      <dependencies>
        <dependency>
          <groupId>org.junit.platform</groupId>
          <artifactId>junit-platform-surefire-provider</artifactId>
          <version>1.10.2</version>
        </dependency>
        <dependency>
          <groupId>org.junit.jupiter</groupId>
          <artifactId>junit-jupiter-engine</artifactId>
          <version>5.10.2</version>
        </dependency>
      </dependencies>
    </plugin>
  </plugins>
</build>

2. 验证测试类的规范性 #

• 确保测试类使用JUnit Jupiter的@Test注解（org.junit.jupiter.api.Test），而非JUnit 4的旧注解；
• 检查测试类命名是否符合默认扫描规则：*Test.java、Test*.java或*Tests.java，若自定义命名需在插件配置中添加包含规则：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.2.5</version>
  <configuration>
    <includes>
      <include>**/*CustomTest.java</include>
    </includes>
  </configuration>
</plugin>

• 测试类需为public访问权限。

3. 确保依赖完整且无隐性冲突 #

• 显式引入JUnit Jupiter核心依赖，保证版本统一：

<dependencies>
  <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.10.2</version>
    <scope>test</scope>
  </dependency>
  <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.10.2</version>
    <scope>test</scope>
  </dependency>
  <dependency>
    <groupId>org.junit.platform</groupId>
    <artifactId>junit-platform-launcher</artifactId>
    <version>1.10.2</version>
    <scope>test</scope>
  </dependency>
</dependencies>

• 运行mvn dependency:tree -Dverbose排查隐性依赖冲突，若发现其他依赖引入旧版本JUnit包，添加排除规则：

<dependency>
  <groupId>第三方依赖groupId</groupId>
  <artifactId>第三方依赖artifactId</artifactId>
  <version>版本号</version>
  <exclusions>
    <exclusion>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
    </exclusion>
    <exclusion>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-api</artifactId>
    </exclusion>
  </exclusions>
</dependency>

4. 对齐命令行与IDE的运行环境 #

• 命令行运行时需指定正确的Eclipse插件环境参数，确保无头模式下插件加载正常：

mvn clean verify -Djava.awt.headless=true -Declipse.application=org.eclipse.ui.ide.workbench -Declipse.product=org.eclipse.platform.ide

• 确认命令行使用的JDK版本与Eclipse一致，避免因JDK版本差异导致类加载异常。

5. 检查测试源目录配置 #

若测试类未放在默认的src/test/java目录，需在pom.xml中指定测试源路径：

<build>
  <testSourceDirectory>src/custom-test/java</testSourceDirectory>
</build>

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