构建与依赖 / 系统课时
运行指定测试类与测试方法
运行指定测试类与测试方法
排查单个失败用例时,没有必要每次执行整个测试集。Maven Surefire 可以通过 -Dtest 精确选择测试类、测试方法或名称模式。本课用可直接复制的命令完成单类、单方法和批量筛选,并说明没有匹配测试时应怎样判断结果。
学习目标
- 能使用
-Dtest只运行指定测试类或测试方法。 - 能用逗号、通配符和方法模式缩小本地测试范围。
- 能根据 Surefire 的执行结果判断名称写错、方法未匹配等常见问题。
先准备一个可筛选的测试类
下面的命令假设 Maven 项目已经使用 JUnit Jupiter,并存在测试类 CalculatorTest。为了理解后面的筛选条件,可以把测试类写成下面这样;这是片段示例,依赖项目 pom.xml 已配置 JUnit Jupiter 测试依赖。
import static org.junit.jupiter.api.Assertions.assertEquals;
import org.junit.jupiter.api.Test;
class CalculatorTest {
@Test
void addsPositiveNumbers() {
assertEquals(5, 2 + 3);
}
@Test
void addsNegativeNumbers() {
// 保留第二个方法,便于验证方法级筛选是否真的生效。
assertEquals(-5, -2 + -3);
}
}验证基线时先执行整个测试集:
mvn test预期结果:两个测试均通过时构建成功;不同 Surefire 版本的日志格式可能不同,但末尾应出现:
BUILD SUCCESS只运行一个测试类
Surefire 的 test 用户属性可以覆盖本次命令的测试选择范围。要只运行 CalculatorTest,在项目根目录执行下面的命令即可,不需要修改 pom.xml。
mvn -Dtest=CalculatorTest test预期结果:只选择 CalculatorTest,其中两个测试方法执行成功,Maven 最终返回成功状态。
BUILD SUCCESS如果项目存在同名测试类,可以写完整类名进一步消除歧义,例如 -Dtest=com.example.CalculatorTest。在 Windows PowerShell、Bash 和 zsh 中,包含 *、# 等模式字符时建议把整个属性参数加引号,避免 Shell 对字符进行额外解释。
精确运行一个测试方法
定位到具体失败方法后,可以使用 类名#方法名。下面的命令只选择 CalculatorTest 中的 addsPositiveNumbers,另一个测试方法不会运行。
mvn "-Dtest=CalculatorTest#addsPositiveNumbers" test预期结果:指定方法通过后构建成功。测试耗时、插件前缀等日志内容属于动态信息,因此这里只检查稳定的构建结果。
BUILD SUCCESS方法名必须与测试框架实际发现的方法一致。若把参数写成不存在的 CalculatorTest#addPositiveNumber,Surefire 3.x 默认会把“指定了测试但没有匹配到测试”作为失败处理;此时应首先检查拼写,而不是误以为测试已经通过。
一次选择多个类或名称模式
多个测试类可以用逗号组合。例如项目同时存在 CalculatorTest 与 TaxServiceTest 时,可以只执行这两类测试:
mvn "-Dtest=CalculatorTest,TaxServiceTest" test预期结果:两个指定测试类中的测试全部通过时构建成功。
BUILD SUCCESS需要按命名批量筛选时可以使用通配符。下面的命令选择名称以 ServiceTest 结尾的测试类;引号用于避免命令行环境处理通配符。
mvn "-Dtest=*ServiceTest" test预期结果:所有匹配 *ServiceTest 的测试执行完成且没有失败时,构建结果为:
BUILD SUCCESS这类模式适合本地快速回归某一组测试,例如 *RepositoryTest 或 *ControllerTest。它不能替代稳定的测试分类策略;名称规则过于宽泛时,仍可能执行比预期更多的测试。
遇到没有匹配测试时怎么查
指定测试失败时,按“类名、方法名、测试框架发现”三个层次检查最快。先确认文件位于 src/test/java 且已经能通过 mvn test 执行,再逐步把筛选范围从类缩小到方法。
可以先验证类级筛选:
mvn "-Dtest=CalculatorTest" test预期结果:如果这里成功,而 -Dtest=CalculatorTest#addsPositiveNumbers 失败,问题通常集中在方法名或测试框架对该方法的发现,而不是 Maven 测试源码目录。
BUILD SUCCESS不要为了绕过拼写错误而长期使用 -Dsurefire.failIfNoSpecifiedTests=false。这个参数适合某些多模块构建中允许部分模块没有目标测试的场景;日常定位单测时保留默认失败行为,反而能立即暴露“命令看似执行成功,实际上一个目标测试都没跑”的问题。