1 / 4概念
Toolchain: Testing
测试的价值不在数量,而在失败时能否指出是哪一层坏了。JUnit 5 把发现与执行拆给 Platform 与 engine,surefire 与 failsafe 再把单元测试与集成测试放到生命周期里不同的位置;判断标准是能否说清一条用例由谁发现、在哪个 JVM 里跑、失败时报告落在哪里。
1 概念
1.1 一句话定义
JUnit 5 由 Jupiter、Platform 与 engine 三层组成:Jupiter 提供注解与断言,Platform 负责发现与调度,Jupiter engine 真正执行用例。surefire 与 failsafe 只是启动器,按文件名把请求交给 Platform。
1.2 它解决什么问题
- 可执行的规格:断言把预期写成代码,失败直接指出偏差。
- 隔离与可重复:每条用例独立建实例、独立准备数据,结果不依赖顺序。
- 分层反馈:单元测试在秒级给出信号,集成测试才碰真实依赖。
- 真实依赖验证:容器提供与生产同版本的数据库,而不是内存替身。
1.3 不属于本页的内容
| 主题 | 去哪 |
|---|---|
| 依赖版本、BOM 与 scope | Build and Dependencies |
可执行 jar、jlink 与发布 | Packaging and Release |
| 类加载与 fork 隔离原理 | Class Loading |
| 测试报告聚合与流水线门禁 | CI/CD |
| 静态检查与告警阈值 | Code Quality |
| 私有镜像仓库与凭据 | Private Registry |
1.4 关键术语
| 术语 | 含义 | 容易混淆的点 |
|---|---|---|
| Jupiter | 编写测试的 API 与注解 | 不是运行时 |
| Platform | 发现与调度的引擎宿主 | 不含断言 |
| engine | 实际执行用例的组件 | Jupiter 只是其中一个 |
| extension | 在固定节点插入逻辑的扩展点 | 不是事件总线 |
@Nested | 用内部类分组用例 | 不是继承复用 |
| tag | 可筛选的标签 | 与包名无关 |
| 参数化测试 | 同一逻辑多组输入 | 不是循环加断言 |
| 动态测试 | 运行时生成用例 | 编译期不可见 |
| test double | 替身的统称 | 不等于 mock |
| Testcontainers | 用容器提供真实依赖 | 不是内存数据库 |
| flaky | 结果不稳定的用例 | 重试只是止血 |
2 机制
2.1 心智模型
Platform 先在内存里建一棵树:engine、容器(类与 @Nested 内部类)、用例。筛选条件先剪枝,执行器再按深度优先走这棵树,扩展在节点前后插入回调。启动器只做一件事:fork 一个 JVM,把这棵树交给 Platform。
2.2 机制拆解
- 实例生命周期:默认每条用例新建实例,
@BeforeAll因此只能是静态方法;改用PER_CLASS后可以在实例方法上写@BeforeAll,代价是状态在方法间共享。 @Nested的语义:内部类共享外部实例,@BeforeEach由外向内执行,@AfterEach由内向外执行。- 断言与汇总:普通断言在第一个失败处终止,
assertAll收集全部失败再一次性报告。 - 参数化与动态:
@ParameterizedTest在发现期按数据源展开成多条用例,@TestFactory在执行期生成用例。 - 扩展模型:扩展实现回调接口,按注册顺序执行;
ParameterResolver让用例方法声明额外参数,TestExecutionExceptionHandler可以包装异常做诊断。 - 替身的边界:只替换自己拥有的协作方,第三方库用真实实例,外部服务用容器。
- 容器化依赖:
@Container静态字段随类启动一次,@Testcontainers负责启停,镜像标签应固定。 - 启动器分工:surefire 按
*Test一类命名匹配并绑定test,failsafe 按*IT匹配并绑定integration-test与verify。
2.3 完整枚举
JUnit Jupiter 公开的扩展回调接口,按调用时机排列:
| 接口 | 调用时机 |
|---|---|
BeforeAllCallback | 容器内所有用例之前 |
BeforeEachCallback | 每条用例之前 |
BeforeTestExecutionCallback | @BeforeEach 之后、用例之前 |
AfterTestExecutionCallback | 用例之后、@AfterEach 之前 |
AfterEachCallback | 每条用例之后 |
AfterAllCallback | 容器内所有用例之后 |
TestInstancePreConstructCallback | 实例构造之前 |
TestInstanceFactory | 替换默认的实例创建 |
TestInstancePostProcessor | 实例创建之后 |
TestInstancePreDestroyCallback | 实例销毁之前 |
ParameterResolver | 解析方法或构造器参数 |
TestExecutionExceptionHandler | 用例抛出异常时 |
LifecycleMethodExecutionExceptionHandler | 生命周期方法抛出异常时 |
TestWatcher | 观察成功、失败与跳过 |
TestTemplateInvocationContextProvider | @TestTemplate 的每次调用 |
InvocationInterceptor | 包裹方法、构造器与生命周期的调用 |
ExecutionCondition | 判断容器或用例是否启用 |
两种启动器的分工与绑定:
| 插件 | 默认匹配 | 绑定阶段 | 失败表现 |
|---|---|---|---|
| surefire | *Test、Test*、*Tests、*TestCase | test | 构建在 test 阶段失败 |
| failsafe | *IT、IT*、*ITCase | integration-test 跑,verify 判定 | 构建在 verify 阶段失败 |
2.4 关键数字与量级
| 指标 | 量级 | 说明 |
|---|---|---|
| 单条单元测试 | 毫秒级 | 超过百毫秒通常说明碰了 IO |
| 单条集成测试 | 秒到数十秒 | 含容器启动与数据准备 |
| 容器启动 | 五到三十秒 | 镜像已在本地时明显更快 |
| JVM fork 启动 | 零点五到两秒 | fork 越多总耗时越长 |
| 覆盖率阈值 | 百分之六十到八十 | 低于此值通常只覆盖了主干 |
3 实践
3.1 最小示例
一个用例同时用到 @Nested、assertAll 与自定义 ParameterResolver:
class PriceTest {
@Nested
@ExtendWith(FixedClock.class)
class Discount {
@Test
void appliesTenPercent(Clock clock) {
var price = Price.of(100);
assertAll(
() -> assertEquals(90, price.discounted(10, clock).cents()),
() -> assertEquals(100, price.cents())
);
}
}
static class FixedClock implements ParameterResolver {
@Override
public boolean supportsParameter(ParameterContext p, ExtensionContext c) {
return p.getParameter().getType() == Clock.class;
}
@Override
public Object resolveParameter(ParameterContext p, ExtensionContext c) {
return Clock.fixed(Instant.parse("2026-01-01T00:00:00Z"), ZoneOffset.UTC);
}
}
}
追踪 ./mvnw test:Platform 发现的树是 PriceTest、内部类 Discount、用例 appliesTenPercent 三层;创建实例后进入用例,supportsParameter 先答“能解析”,resolveParameter 再注入固定时钟,assertAll 跑完两个断言并把失败一并报告。文件名匹配 *Test,surefire 在 test 阶段执行;换成 PriceIT 则 surefire 跳过,改由 failsafe 在 verify 阶段执行。
3.2 常用操作与参数
| 操作 | 写法 | 说明 |
|---|---|---|
| 标记用例 | @Test | 由 Jupiter engine 发现 |
| 参数化 | @ParameterizedTest 加 @CsvSource | 每组数据展开一条用例 |
| 动态用例 | @TestFactory | 执行期生成,适合表格驱动 |
| 分组筛选 | @Tag("slow") | 用 -Dgroups 或 -DexcludedGroups 过滤 |
| 替换协作方 | @ExtendWith(MockitoExtension.class) 加 @Mock | 只替换自己拥有的边界 |
| 真实依赖 | @Testcontainers 加 @Container | 随类启停,镜像固定标签 |
| 跑集成测试 | ./mvnw verify -Dit.test=OrderIT | failsafe 在 verify 判定 |
| 并行执行 | junit.jupiter.execution.parallel.enabled=true | 前提是用例之间无共享状态 |
3.3 标准流程
- 先按命名分开两层:
*Test只碰内存,*IT才碰数据库、容器与网络。 - 用例只断言行为与输出,不断言内部调用次数,除非调用本身就是契约。
- 每条用例自备数据并在结束时清理,不依赖执行顺序。
- 时间、随机数与 ID 生成全部注入,不用系统时钟。
- 容器镜像固定到具体标签,启动参数写进测试代码而不是本机配置。
- 报告、覆盖率与失败重试策略交给 CI,本地只保留快速子集。
3.4 与相邻技术的组合
- Build and Dependencies:测试依赖用
testscope 声明,版本由同一份 BOM 约束。 - Packaging and Release:
verify通过才允许打包与发布,集成测试失败即中止。 - CI/CD:聚合 surefire 与 failsafe 报告,缓存容器镜像与本地仓库。
- Code Quality:覆盖率与变异得分作为门禁,阈值写进构建而不是口头约定。
- Spring Boot:切片测试只装配需要的 bean,
@SpringBootTest留给端到端。
3.5 选型维度
| 维度 | 取值 | 影响 |
|---|---|---|
| 层级配比 | 单元为主 / 集成为主 | 决定反馈速度与置信度 |
| 替身策略 | mock / fake / 真实实例 | fake 更稳,mock 更省事 |
| 真实依赖 | 内存替身 / 容器 | 容器贴近生产,启动更慢 |
| 隔离方式 | 每例新建 / 共享容器 | 共享快但要求无状态 |
| 并行 | 关闭 / 按类 / 按方法 | 并行越快,隔离要求越高 |
| 失败策略 | 立即中止 / 全量报告 | 全量报告更利于一次修完 |
3.6 决策规则
- 能写成纯函数的地方优先单元测试,容器只用于验证映射与事务。
- 第三方服务用容器或 fake,不用深度 mock 模拟协议。
- 断言对象是返回值与数据库状态,不是日志与私有字段。
- 集成测试依赖的镜像标签应固定,禁用
latest。 - 出现 flaky 先定位共享状态与时钟依赖,不要先加重试。
3.7 替代方案对比
| 方案 | 优势 | 代价 | 适用 |
|---|---|---|---|
| JUnit 5 | 扩展模型完整、生态最广 | 注解与扩展需要学习 | 绝大多数 JVM 工程 |
| JUnit 4 加 Vintage | 迁移期兼容旧用例 | 两套注解并存,易混用 | 渐进迁移 |
| Spock | 规格化写法可读性高 | 需 Groovy,团队门槛高 | Groovy 技术栈 |
3.8 何时不该用
- 一次性验证脚本,
main方法加断言已经够用。 - 没有真实依赖差异时,不要为“像生产”启动容器。
- 不要为覆盖率数字补没有断言的用例。
- 不要在单元测试里启动整个应用上下文。
4 边界
4.1 典型故障
| 症状 | 根因 | 处理 |
|---|---|---|
| 报告里零个用例 | 命名不匹配,或 @Test 来自 JUnit 4 | 按 *Test 命名,或加 Vintage engine |
| 单独跑通过、全量跑失败 | 静态可变状态或共享容器跨类泄漏 | 每例重置状态,容器按类隔离 |
| 容器启动超时 | 镜像未预热、端口冲突 | 预热镜像,固定端口映射,上调超时 |
| 换个顺序就失败 | 用例之间存在隐式顺序依赖 | 自备数据,用随机顺序验证 |
| 覆盖率很高但没测行为 | 只断言 mock 被调用 | 断言返回值与持久化结果 |
| 同一用例偶发失败 | 时钟、并发或外部服务抖动 | 注入固定时钟,隔离数据,标记后排查 |
4.2 反模式
| 做法 | 后果 | 替代 |
|---|---|---|
| 断言 mock 的调用次数 | 重构即失败,行为没变 | 断言输出与副作用 |
| 用例之间共享数据库行 | 顺序一变就红 | 每例独立数据 |
用 Thread.sleep 等待异步结果 | 偶发失败且拖慢构建 | 用轮询加超时 |
| 重试掩盖 flaky | 问题被藏起来 | 先定位共享状态 |
4.3 可观测信号
用例总数与两层配比、单条耗时分布、失败率、flaky 比例、覆盖率与变异得分、容器启动时长、verify 阶段耗时。排障顺序为:发现结果、实例生命周期、共享状态。
4.4 安全 / 性能 / 一致性边界
- 安全边界:测试容器与镜像来自可信仓库,凭据用环境变量注入,不写进测试代码。
- 性能边界:并行只提升吞吐,不改变语义;共享容器省时间,但要求用例无状态。
- 一致性边界:时间、随机数与外部响应都要可控,否则同一 commit 会给出不同结果。
- 隔离边界:fork 与 classpath 决定隔离粒度,静态状态是跨用例污染的主要来源。