如何通过Maven在JUnit测试套件中运行指定测试方法？

我需要一条Maven命令来执行单个JUnit @Test方法，但我的测试都放在由TestWrapper类调用的测试套件里——这个Wrapper类负责所有测试类的测试数据初始化和清理。

现有代码结构 #

TestWrapper类代码：

@RunWith(Suite.class)
@SuiteClasses({
   TestClassA.class,
   TestClassB.class,
})
public class TestWrapper
{
   @BeforeClass
   public static void dataSetup() throws Exception
   {
      // 创建测试数据
   }
   
   @AfterClass
   public static void dataTeardown() throws Exception
   {
      // 清理测试数据
   }
}

示例测试类TestClassA代码：

public class TestClassA
{
   @Test
   public void someTest()
   {
      // 测试内容
   }

   @Test
   public void anotherTest()
   {
      // 测试内容
   }
}

当前执行所有测试的Maven命令：

mvn verify -Dtest=**/TestWrapper test 

遇到的问题 #

想单独执行TestClassA.someTest，但尝试的方案都有问题：

• 使用-Dtest=**/TestWrapper#someTest执行失败，因为someTest不是TestWrapper的方法；
• 使用-Dtest="**/TestWrapper, **/TestClassA#someTest"时，会通过Wrapper执行目标测试，但还会单独再执行一次该测试，第二次因缺少Wrapper的测试数据而失败。

可行解决方案 #

方案一：使用JUnit @Category注解配合Maven Surefire插件

1. 定义一个标记接口：

public interface SingleTestMarker {}

2. 在目标测试方法上添加@Category注解：

@Test
@Category(SingleTestMarker.class)
public void someTest() {
    // 测试内容
}

3. 修改TestWrapper类，添加@IncludeCategory注解：

@RunWith(Suite.class)
@SuiteClasses({TestClassA.class, TestClassB.class})
@IncludeCategory(SingleTestMarker.class)
public class TestWrapper {
   // 原有的@BeforeClass和@AfterClass方法保持不变
}

4. 执行Maven命令：

mvn verify -Dtest=**/TestWrapper test

此方法会仅执行标记了SingleTestMarker的测试方法，同时完整执行TestWrapper的初始化和清理逻辑。

方案二：配置Maven Surefire插件指定测试方法

在pom.xml的build节点下添加Surefire插件配置：

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

执行命令：

mvn verify test

该配置强制Surefire只运行TestWrapper套件，且仅执行名为someTest的方法。需要切换测试方法时，修改includedTestMethods的值即可。

方案三：直接通过命令行参数筛选（最灵活）

利用Surefire的测试筛选语法，指定运行TestWrapper套件，同时过滤出目标方法：

mvn verify -Dtest=TestWrapper -Dincludes=**/TestClassA.java#someTest test

注：路径匹配可根据项目结构调整，若测试类在默认的src/test/java目录下，直接写类名即可，无需全路径。

方案对比 #

• 方案一：适合需要多次重复执行同一单个测试的场景，标记一次后可重复执行命令；
• 方案二：适合在pom中固定配置，临时切换测试方法只需修改配置；
• 方案三：无需修改代码或pom，直接通过命令行指定，灵活性最高。

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