如何通过Maven命令行动态传递JUnit测试套件的Category？

直接在JUnit套件注解里用${Category}.class这种Maven变量是行不通的——Java注解参数必须是编译时常量，Maven的变量替换在编译阶段完成，无法实现运行时动态传入。下面提供两种实用方案，帮你避免重复创建测试套件：

方案一：利用Maven Surefire插件直接指定Category（推荐） #

无需自定义代码，直接通过Surefire插件的groups参数筛选测试类别，同时可限定测试类范围：

1. 修改pom.xml配置Surefire插件

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-surefire-plugin</artifactId>
            <version>3.2.5</version>
            <configuration>
                <!-- 通过系统变量传入Category全类名 -->
                <groups>${test.category}</groups>
                <!-- 可选：限定只运行指定的测试类（和原套件范围一致） -->
                <includes>
                    <include>**/MyTest1.class</include>
                    <include>**/MyTest2.class</include>
                </includes>
            </configuration>
        </plugin>
    </plugins>
</build>

2. 命令行运行指定Category

mvn test -Dtest.category=com.example.MyCategory

3. Jenkins集成
   在Jenkins构建任务中添加字符串参数，参数名设为test.category，运行时直接填入目标Category的全类名即可。

方案二：自定义Categories Runner（严格控制测试套件范围） #

如果必须通过JUnit测试套件类来限定测试范围，可以自定义Runner读取系统属性，动态加载Category：

1. 创建通用测试套件类

@RunWith(CustomCategoriesRunner.class)
@Suite.SuiteClasses({
    MyTest1.class,
    MyTest2.class,
    // 所有需要纳入套件的测试类
})
public class DynamicCategorySuite {
    // 空类，仅承载注解配置
}

2. 实现自定义Categories Runner

import org.junit.runner.Runner;
import org.junit.runner.notification.RunNotifier;
import org.junit.runners.Categories;
import org.junit.runners.model.InitializationError;
import org.junit.runners.model.RunnerBuilder;

import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.List;

public class CustomCategoriesRunner extends Categories {
    public CustomCategoriesRunner(Class<?> klass, RunnerBuilder builder) throws InitializationError {
        super(klass, builder);
        // 读取命令行传入的Category全类名
        String categoryClassName = System.getProperty("test.category");
        if (categoryClassName != null && !categoryClassName.isEmpty()) {
            try {
                Class<?> categoryClass = Class.forName(categoryClassName);
                // 通过反射修改Categories的includeCategories字段
                Field includeField = Categories.class.getDeclaredField("includeCategories");
                includeField.setAccessible(true);
                List<Class<?>> includes = new ArrayList<>();
                includes.add(categoryClass);
                includeField.set(this, includes);
            } catch (Exception e) {
                throw new InitializationError("加载Category类失败：" + categoryClassName);
            }
        }
    }

    @Override
    public void run(RunNotifier notifier) {
        super.run(notifier);
    }
}

3. 命令行运行指定套件和Category

mvn test -Dtest=DynamicCategorySuite -Dtest.category=com.example.MyCategory

关键说明 #

• 两种方案都支持Jenkins参数化构建，只需在Jenkins中添加对应参数即可动态指定Category。
• 方案一更简洁，无需额外代码；方案二更适合需要严格限定测试类范围的场景。

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