构建与依赖 / 系统课时
使用 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 读取汇总结果并决定构建成功或失败 |

如果环境需要启动和停止动作,应分别绑定到 pre-integration-test 与 post-integration-test,而不是把启动、测试、停止都塞进一个测试方法中。这样测试异常时,生命周期仍有机会执行清理。
配置 Failsafe
下面是 pom.xml 中 build/plugins 下的片段示例。它显式选择 **/*IT.java,并将“没有任何集成测试”也视为配置错误,适合 CI 中防止测试文件被误命名后静默跳过。
<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:
mvn clean verify预期输出(测试全部通过时,省略与本课无关的日志):
[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。