Maven Surefire+JUnit5命令行包含/排除测试不生效如何解决？

你遇到的测试过滤规则不生效的核心原因是Maven多模块聚合项目的参数传递机制：

• 根目录的pom一般为pom打包类型的聚合模块，本身不存在任何测试类，直接在根目录执行带-Dtest参数的构建命令时，规则首先匹配根模块，因为没有找到符合规则的测试就直接抛出了无测试执行的错误，不会继续将参数传递给子模块
• 直接使用-Dincludes/-Dexcludes不生效是因为这两个是maven-surefire-plugin的配置项，对应的系统属性需要添加maven.test.前缀才会被插件识别

方案1：使用-Dtest参数配合忽略无测试错误 #

执行构建时增加-DfailIfNoTests=false参数，忽略根模块和其他过滤后无测试的模块的报错，测试过滤规则会自动应用到所有存在测试的子模块：

# 示例：排除所有名称包含RabbitMQ的测试
mvn package -Dtest='!%regex[.*RabbitMQ.*]' -DfailIfNoTests=false

注意Shell转义规则：Windows cmd环境下不需要单引号，直接写-Dtest=!%regex[.*RabbitMQ.*]即可；bash/zsh环境下如果不使用单引号包裹，需要用反斜杠转义感叹号：-Dtest=\!%regex[.*RabbitMQ.*]

方案2：使用maven.test.excludes参数批量排除测试 #

如果更习惯用路径匹配规则排除测试，可以使用官方支持的maven.test.excludes系统属性，不需要修改pom文件：

# 示例：排除所有test目录下名称包含RabbitMQ的测试类
mvn package -Dmaven.test.excludes='**/*RabbitMQ*.java' -DfailIfNoTests=false

方案3：仅针对指定子模块应用过滤规则 #

如果只需要对部分子模块的测试进行过滤，可以使用-pl参数指定要构建的子模块，配合-am参数同时构建该子模块的所有依赖项，不需要配置忽略无测试错误：

# 示例：仅构建core模块及其依赖，排除core模块下的HostTest测试
mvn package -pl core -am -Dtest=\!HostTest

如果测试代码中对第三方依赖相关的测试加了JUnit5的@Tag注解，还可以直接按标签批量排除，不需要匹配类名，比如RabbitMQ相关测试统一打了@Tag("RabbitMQ")，可以使用以下命令：

mvn package -Dtest.excludeCategories='org.junit.jupiter.api.Tag("RabbitMQ")' -DfailIfNoTests=false

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