Maven Surefire插件2.22.0+版本无法识别JUnit5标签的-Dgroups参数求助

问题详情 #

• 运行环境：Java 8
• 执行测试命令：mvn surefire:test -Psurefire -Dgroups="downloadWars"
• 出现警告：

[WARNING] Couldn't load group class 'downloadWars' in Surefire|Failsafe plugin. The group class is ignored!

• 背景：该命令在Surefire 2.22.0版本可正常执行，升级到3.1.0/3.2.5版本后出现上述警告，当前POM插件配置如下：

<plugin>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <phase>integration-test</phase>
            <goals>
                <goal>test</goal>
            </goals>
            <configuration>
                <excludes>
                    <exclude>none</exclude>
                </excludes>
                <includes>
                    <include>**/*IntegrationTest</include>
                </includes>
            </configuration>
        </execution>
    </executions>
</plugin>

解决方法 #

1. 确保分组使用全限定类名 #

Surefire 3.x对分组类的解析逻辑更严格，不再支持简写的分组名称。需要在命令行中指定分组接口/类的全限定类名：

mvn surefire:test -Psurefire -Dgroups="com.yourpackage.DownloadWarsGroup"

对应的测试类分组定义示例：

// 定义分组接口
package com.yourpackage;
public interface DownloadWarsGroup {}

// 测试类关联分组
import org.junit.experimental.categories.Category;
@Category(DownloadWarsGroup.class)
public class YourIntegrationTest {
    // 测试方法
}

2. 显式启用类别支持 #

在POM的Surefire插件配置中添加<useCategories>true</useCategories>，确保插件正确识别JUnit的@Category注解：

<plugin>
    <artifactId>maven-surefire-plugin</artifactId>
    <version>3.1.0</version>
    <executions>
        <execution>
            <phase>integration-test</phase>
            <goals>
                <goal>test</goal>
            </goals>
            <configuration>
                <excludes>
                    <exclude>none</exclude>
                </excludes>
                <includes>
                    <include>**/*IntegrationTest</include>
                </includes>
                <useCategories>true</useCategories>
            </configuration>
        </execution>
    </executions>
</plugin>

3. 验证参数传递是否正确 #

添加-X参数运行命令，查看Debug日志确认-Dgroups参数是否被正确传递到Surefire插件：

mvn surefire:test -Psurefire -Dgroups="com.yourpackage.DownloadWarsGroup" -X

在日志中搜索groups关键字，确认插件接收到的参数值是否符合预期。

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