如何确保-Dtest指定的测试仅在Surefire包含范围内运行？

问题场景 #

我在pom.xml中为测试套件定义了Profile，配置如下：

<profile>
    <id>profile-a-tests</id>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.0.0-M5</version>
                <configuration>
                    <includes>
                        <include>**/ATestSuite**</include>
                    </includes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</profile>

对应的测试套件代码：

@Suite
@SuiteDisplayName("A test suite")
@SelectPackages("com.mypackage.tests")
@IncludeTags(INCLUDE)
@ExcludeTags(EXCLUDE)
class ATestSuite

在Jenkins中执行以下Maven命令时，发现即便SOME_FLAKY_TEST不在ATestSuite范围内，仍会被执行：

mvn test -P profile-a-tests -Dtest=SOME_FLAKY_TEST

需要明确：-Dtest是否会覆盖Surefire的includes/excludes配置？如何实现仅运行套件范围内且命令指定的测试？

问题解答 #

1. -Dtest对Surefire配置的影响 #

-Dtest参数会完全覆盖Surefire插件中配置的<includes>/<excludes>规则。当你在命令行指定-Dtest=SOME_FLAKY_TEST时，Surefire会直接忽略pom里定义的测试套件范围，转而查找并运行指定的测试类，这就是不在套件范围内的测试仍被执行的原因。

2. 解决方案 #

方案1：结合标签实现精准过滤

这是最推荐的方式，利用测试标签实现套件范围+指定测试的双重过滤：

• 给目标不稳定测试添加专属标签：

@Tag("flaky")
class SOME_FLAKY_TEST {
    // 测试逻辑
}

• 执行命令时，通过-Dgroups参数指定仅运行该标签的测试：

mvn test -P profile-a-tests -Dgroups=flaky

这样Surefire会先按照ATestSuite的规则筛选出符合条件的测试，再从中挑选带有flaky标签的测试执行，完全符合需求。

方案2：命令行参数限定测试范围

如果不想使用标签，可以直接在-Dtest中指定测试的完整包路径，与套件的@SelectPackages保持一致：

mvn test -P profile-a-tests -Dtest=com.mypackage.tests.SOME_FLAKY_TEST

这种方式会直接定位到指定包下的测试类，若测试不在该包范围内，命令会找不到目标测试，自然不会执行。

方案3：pom动态配置交集过滤

如果需要更灵活的复用配置，可以修改Profile中的Surefire配置，将基础范围与命令行参数结合为交集：

<profile>
    <id>profile-a-tests</id>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>3.0.0-M5</version>
                <configuration>
                    <!-- 基础范围：套件覆盖的包路径 -->
                    <includes>
                        <include>com/mypackage/tests/**/*.class</include>
                    </includes>
                    <!-- 允许命令行通过-Dtest.filter指定具体测试 -->
                    <test>${test.filter:*}</test>
                </configuration>
            </plugin>
        </plugins>
    </build>
</profile>

执行命令时指定目标测试：

mvn test -P profile-a-tests -Dtest.filter=SOME_FLAKY_TEST

Surefire会先筛选出指定包下的所有测试，再匹配命令行指定的测试类，实现范围交集。

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