构建与依赖 / 系统课时
跳过测试的不同方式
跳过测试的不同方式
Maven 常见的两个跳过参数看起来只差一个名字,实际跳过的阶段不同:skipTests 仍会编译测试源码,而 maven.test.skip 连测试编译也会跳过。本课用一个故意无法通过测试编译的项目直接验证差异,并给出 CI 与临时构建的选择规则。
学习目标
- 区分
skipTests与maven.test.skip对测试编译和测试执行的影响。 - 能用构建日志判断失败发生在
testCompile还是测试运行阶段。 - 知道本地临时构建、集成测试和发布流水线分别该怎样处理跳过参数。
两个参数跳过的环节不同
对于默认 jar 项目,测试源码通常先由 compiler:testCompile 编译,再由 Surefire 的 surefire:test 运行。两个参数的关键差异就在这里。
| 构建方式 | 编译 src/test/java |
运行 Surefire 单元测试 | 风险 |
|---|---|---|---|
| 不跳过 | 是 | 是 | 可靠性最高 |
skipTests=true |
是 | 否 | 能发现测试源码编译错误,但发现不了断言失败 |
maven.test.skip=true |
否 | 否 | 连测试源码是否能编译都不知道 |
如果只是为了临时缩短本地打包时间,优先考虑 skipTests;只有明确接受“测试源码可能已经坏掉”这个风险时才使用 maven.test.skip。对于发布构建或主干 CI,通常应让测试正常执行。
用测试编译错误验证差异
建立一个最小 jar 项目。pom.xml 不需要测试框架,因为我们只利用测试源码中的类型错误验证 testCompile 是否发生。
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>demo</groupId>
<artifactId>skip-test-demo</artifactId>
<version>1.0.0</version>
<properties>
<maven.compiler.source>8</maven.compiler.source>
<maven.compiler.target>8</maven.compiler.target>
</properties>
</project>创建 src/test/java/demo/BrokenTest.java,故意引用不存在的类型:
package demo;
class BrokenTest {
// 只要 testCompile 真正执行,这里就会报 cannot find symbol。
MissingType value;
}先使用 skipTests:
mvn package -DskipTests预期输出
[ERROR] COMPILATION ERROR :
[ERROR] cannot find symbol
[ERROR] symbol: class MissingType
[INFO] BUILD FAILURE这说明 skipTests 只是跳过测试运行,testCompile 仍会执行,所以测试代码连编译都过不了时,构建依然失败。
再使用 maven.test.skip:
mvn package -Dmaven.test.skip=true预期输出
[INFO] BUILD SUCCESS第二次构建能成功,是因为测试源码编译也被跳过。不同 Maven 与插件版本的日志行会有差异,但结果应体现为:前者在测试编译阶段失败,后者不进入测试编译。
根据失败类型选择参数
先判断你真正想跳过的是“测试执行”还是“整个测试编译链路”,不要把两个参数当成等价缩写。
| 场景 | 更合适的处理 | 原因 |
|---|---|---|
| 本地只想快速得到 JAR,同时仍希望检查测试源码能否编译 | 使用 skipTests |
保留 testCompile 这道最低检查 |
| 测试依赖临时不可用,且当前只验证主代码能否打包 | 可短期使用 maven.test.skip |
能绕过测试编译,但必须接受更高风险 |
| 主干 CI、发布候选或正式发布 | 不跳过测试 | 否则测试失败不会阻止产物进入后续阶段 |
| 使用 Failsafe 3.6.0+ 的集成测试 | 使用 skipITs 控制集成测试 |
skipTests 只应视为 Surefire 单元测试的跳过开关 |
maven.test.skip 最危险的地方不是“少跑几分钟测试”,而是它会让测试源码损坏、测试依赖缺失等问题暂时消失。后续恢复测试时,失败往往会一次性暴露,定位成本更高。
用构建日志确认到底跳过了什么
排查时直接看生命周期中的两个位置:是否出现 compiler:testCompile,以及 Surefire 是否真正启动测试。若日志中已经在 testCompile 报错,skipTests 不会救场;若 testCompile 成功但测试断言失败,skipTests 才会让该次构建绕过测试运行。
在 CI 中可把验收规则写得更明确:发布流水线必须看到测试执行与结果报告;只做编译验证的临时流水线可以允许跳过运行,但仍保留测试编译。这样比长期在 POM 中写死跳过参数更容易审计,也能避免开发者忘记恢复测试。