java 单元测试中,可以通过 junit jupiter 提供的 @tag 注解为测试方法或类打上标签,并在构建工具(如 maven 或 gradle)中配置过滤器,从而按需运行特定分组的测试。具体做法是在测试代码中使用 @tag("slow") 等标记,然后在构建命令中添加参数排除或包含这些标签,例如使用 -dgroups=slow 来仅运行被标记的测试,或者使用 -dexcludedgroups=slow 来跳过它们。

如何给测试用例添加分组标签
在 JUnit 5 中,可以使用 @Tag 注解来标识测试组。该注解可以应用于测试类或具体的测试方法上。通常建议将耗时较长、依赖外部资源(如数据库、网络)或需要特殊环境的测试标记为特定组,以便在快速开发循环中跳过它们。

```java
import org.junit.jupiter.api.Tag;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertEquals;
@Tag("integration")
class DatabaseTest {
@Test
@Tag("slow")
void testComplexQuery() {
// 模拟耗时操作
assertEquals(1, 1);
}
@Test
void testSimpleConnection() {
// 快速连接检查
assertEquals(true, true);
}
}
```上述代码中,DatabaseTest 类被标记为 integration 组,而 testComplexQuery 方法额外被标记为 slow 组。这样可以根据需要灵活组合过滤条件。
立即学习“Java免费学习笔记(深入)”;
Maven 如何配置按标签过滤运行
Maven 的 Surefire 插件支持通过 groups 和 excludedGroups 参数来过滤测试。可以在 pom.xml 中配置默认行为,也可以通过命令行动态指定。这种方式允许开发者在不修改代码的情况下,根据当前任务需求选择运行哪些测试。

```xml
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.0.0-M7</version>
<configuration>
<excludedGroups>slow,integration</excludedGroups>
</configuration>
</plugin>
```在上面的配置中,默认情况下会排除标记为 slow 或 integration 的测试。如果只想运行这些测试,可以在命令行中使用 mvn test -Dgroups=slow,integration。这种配置方式使得测试执行策略更加清晰和可控。
当同时应用类和方方法级标签时如何解析优先级
当测试方法和类同时应用了 @Tag 注解时,JUnit 会将它们视为逻辑“与”的关系,即测试必须拥有所有相关标签才会被匹配到对应的组中。这意味着如果一个类被标记为 integration,而其中的一个方法被标记为 slow,那么该方法同时属于 integration 和 slow 两个组。在过滤时,如果指定运行 slow 组,该方法会被选中;如果指定运行 integration 组,它也会被选中。但如果指定运行 slow,integration 组合组,则只有同时具备这两个标签的测试才会被执行。这种机制允许细粒度的控制,但也需要注意标签的组合逻辑,避免意外排除或包含测试。


















