Tycho环境下maven-surefire-plugin误用JUnit4无法检测测试用例

项目采用eclipse-test-plugin打包，因tycho-surefire-plugin无法正常加载Spring注解上下文，转而使用maven-surefire-plugin执行单元测试。这些测试在Eclipse和旧版Maven中可正常运行，但升级Tycho版本后，测试无法执行：

• maven-surefire-plugin自动检测到org.apache.maven.surefire.junit4.JUnit4Provider，但找不到测试用例
• 已按要求添加junit-jupiter-engine和junit-jupiter-api作为插件依赖，问题仍未解决
• 执行mvn dependency:tree未发现JUnit4依赖，但目标平台包含org.eclipse.jdt.junit4.runtime.jar

1. Tycho打包类型的类路径干扰：eclipse-test-plugin打包类型会将目标平台中的org.eclipse.jdt.junit4.runtime纳入类路径，即使项目依赖中没有显式的JUnit4，这个bundle的存在会让Surefire自动选择JUnit4 Provider，而非JUnit5。
2. Surefire配置缺失：未显式指定JUnit5的测试Provider，导致自动检测逻辑出错；同时testClassesDirectory使用了绝对路径，可能在不同环境下失效，且Eclipse插件项目的测试类默认输出路径可能与普通Maven项目不同。
3. 依赖范围错误：JUnit5相关依赖的scope设置为compile，而测试依赖应使用test scope，避免不必要的类路径污染。

1. 强制指定Surefire使用JUnit5 Provider #

在maven-surefire-plugin的配置中显式指定JUnit5的Provider，避免自动检测逻辑误选JUnit4：

<plugin>
  <artifactId>maven-surefire-plugin</artifactId>
  <version>3.5.4</version>
  <executions>
    <execution>
      <id>plain-unit-tests</id>
      <phase>test</phase>
      <goals>
        <goal>test</goal>
      </goals>
      <configuration>
        <exclude>**/*PluginTest.class</exclude>
        <skip>false</skip>
        <failIfNoTests>true</failIfNoTests>
        <!-- 替换为相对路径，避免环境差异 -->
        <testClassesDirectory>${project.build.outputDirectory}</testClassesDirectory>
        <!-- 强制指定JUnit5 Provider -->
        <provider>org.apache.maven.surefire.junitplatform.JUnitPlatformProvider</provider>
      </configuration>
    </execution>
  </executions>
  <dependencies>
    <dependency>
      <groupId>org.junit.jupiter</groupId>
      <artifactId>junit-jupiter-engine</artifactId>
      <version>5.14.0</version>
    </dependency>
    <dependency>
      <groupId>org.junit.platform</groupId>
      <artifactId>junit-platform-surefire-provider</artifactId>
      <version>1.14.0</version>
    </dependency>
  </dependencies>
  <configuration>
    <skip>false</skip>
    <failIfNoTests>true</failIfNoTests>
    <testClassesDirectory>${project.build.outputDirectory}</testClassesDirectory>
    <provider>org.apache.maven.surefire.junitplatform.JUnitPlatformProvider</provider>
  </configuration>
</plugin>

2. 调整依赖范围 #

将JUnit5、Spring Test等测试相关依赖的scope改为test，避免类路径污染：

<dependencies>
  <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.14.0</version>
    <scope>test</scope>
  </dependency>
  <dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.14.0</version>
    <scope>test</scope>
  </dependency>
  <dependency>
    <groupId>org.junit.platform</groupId>
    <artifactId>junit-platform-launcher</artifactId>
    <version>1.14.0</version>
    <scope>test</scope>
  </dependency>
  <dependency>
    <groupId>org.springframework</groupId>
    <artifactId>spring-test</artifactId>
    <version>6.2.11</version>
    <scope>test</scope>
  </dependency>
  <dependency>
    <groupId>org.mockito</groupId>
    <artifactId>mockito-core</artifactId>
    <version>5.20.0</version>
    <scope>test</scope>
  </dependency>
</dependencies>

3. 排除目标平台中的JUnit4 Runtime（可选） #

如果上述步骤仍未解决，可在Tycho配置中排除org.eclipse.jdt.junit4.runtime，避免其干扰类路径：

<plugin>
  <groupId>org.eclipse.tycho</groupId>
  <artifactId>tycho-maven-plugin</artifactId>
  <version>4.0.12</version>
  <extensions>true</extensions>
  <configuration>
    <excludedBundles>
      <bundle>org.eclipse.jdt.junit4.runtime</bundle>
    </excludedBundles>
  </configuration>
</plugin>

4. 验证配置 #

执行以下命令清理并运行测试，确认问题解决：

mvn clean test

内容的提问来源于stack exchange，提问作者Árpád Magosányi