构建与依赖 / 系统课时

使用 Failsafe 执行集成测试

使用 Failsafe 执行集成测试

集成测试常要先启动数据库、容器或测试服务,再执行用例,最后无论成功失败都完成清理。本课把 Failsafe 绑定到 integration-test 与 verify,并用 mvn verify 保证测试失败时仍能走到清理阶段,再由最终校验决定构建是否失败。

学习目标

  • 正确区分 pre-integration-test、integration-test、post-integration-test 与 verify 的职责。
  • 配置 Maven Failsafe Plugin 3.6.0 执行 *IT.java 集成测试。
  • 用报告目录和构建结果确认集成测试、清理与结果校验都已执行。

把集成测试放进完整生命周期

Failsafe 的关键不是换一个测试插件,而是把“执行测试”和“判定失败”拆开。下面的阶段顺序适合需要外部资源的集成测试;本例按 Failsafe 3.6.0 编写,该版本要求运行 Maven 的环境至少为 Maven 3.6.3、JDK 8。

阶段 直接用途 项目中的典型动作
pre-integration-test 准备环境 启动测试数据库、容器或本地服务
integration-test 执行集成测试 Failsafe 运行 *IT.java
post-integration-test 清理环境 停止服务、删除临时资源
verify 校验测试结果 Failsafe 读取汇总结果并决定构建成功或失败

Failsafe 集成测试生命周期

如果环境需要启动和停止动作,应分别绑定到 pre-integration-test 与 post-integration-test,而不是把启动、测试、停止都塞进一个测试方法中。这样测试异常时,生命周期仍有机会执行清理。

配置 Failsafe

下面是 pom.xml 中 build/plugins 下的片段示例。它显式选择 **/*IT.java,并将“没有任何集成测试”也视为配置错误,适合 CI 中防止测试文件被误命名后静默跳过。

xml
<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-failsafe-plugin</artifactId>
  <version>3.6.0</version>
  <configuration>
    <includes>
      <include>**/*IT.java</include>
    </includes>
    <failIfNoTests>true</failIfNoTests>
  </configuration>
  <executions>
    <execution>
      <id>integration-tests</id>
      <goals>
        <goal>integration-test</goal>
        <goal>verify</goal>
      </goals>
    </execution>
  </executions>
</plugin>

将测试类放在 Maven 默认测试源码目录,例如 src/test/java/com/example/OrderRepositoryIT.java。integration-test 会写入 target/failsafe-reports,verify 再读取汇总文件并根据失败数决定最终构建状态。

用 verify 执行并检查结果

在项目根目录执行完整生命周期,不要只调用 integration-test:

bash
mvn clean verify

预期输出(测试全部通过时,省略与本课无关的日志):

text
[INFO] Tests run: 1, Failures: 0, Errors: 0, Skipped: 0
[INFO] BUILD SUCCESS

执行后检查 target/failsafe-reports。应至少看到本次集成测试的 XML 或文本报告,以及 failsafe-summary.xml;文件名会随测试类变化。若设置了 failIfNoTests=true 却没有匹配 *IT.java 的测试,构建应失败,而不是显示“成功但没有测到任何内容”。

失败时仍让清理阶段执行

Failsafe 在 integration-test 阶段记录测试失败,但把最终失败判定留到 verify,因此位于两者之间的 post-integration-test 可以继续执行。对需要临时数据库、容器或服务的项目,这能避免“测试一失败,环境就留在后台”的问题。

命令 会执行到哪里 适用性
mvn integration-test 停在 integration-test 不适合作为常规集成测试命令,后续清理和最终校验不会执行
mvn verify 一直到 verify 推荐,能执行清理并在最后检查测试结果

验证失败路径时,可以临时让一个 *IT.java 断言失败,再执行 mvn verify。正确现象是清理阶段先完成,随后在 verify 阶段得到 BUILD FAILURE;若资源没有清理,应检查负责停止资源的插件是否真的绑定到了 post-integration-test。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Failsafe 执行集成测试

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

登录哪都通