构建与依赖 / 系统课时

跳过测试的不同方式

跳过测试的不同方式

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 是否发生。

xml
<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,故意引用不存在的类型:

java
package demo;

class BrokenTest {
    // 只要 testCompile 真正执行,这里就会报 cannot find symbol。
    MissingType value;
}

先使用 skipTests:

bash
mvn package -DskipTests

预期输出

text
[ERROR] COMPILATION ERROR :
[ERROR] cannot find symbol
[ERROR]   symbol:   class MissingType
[INFO] BUILD FAILURE

这说明 skipTests 只是跳过测试运行,testCompile 仍会执行,所以测试代码连编译都过不了时,构建依然失败。

再使用 maven.test.skip:

bash
mvn package -Dmaven.test.skip=true

预期输出

text
[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 中写死跳过参数更容易审计,也能避免开发者忘记恢复测试。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

跳过测试的不同方式

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通