Assumptions用于动态跳过不适用环境的测试而非使其失败；assumeTrue等检查前提，不满足则静默跳过（skipped），assertTrue等验证逻辑，不满足则失败。
Java 单元测试中的 Assumptions（假设）用于在运行时**动态跳过**某些测试，而不是让它们失败。它适用于“只在特定环境/条件下才有意义”的测试场景，比如：JDK 版本限制、系统属性存在、环境变量配置、第三方服务可达性等。
什么时候该用 assume 而不是 assert？
assume 表示“如果条件不满足，这个测试就不该执行”；assert 表示“条件必须满足，否则测试失败”。二者语义完全不同：
- 用
assumeTrue(…)检查前提是否成立——不成立则静默跳过该测试（显示为“skipped”，不是 failure 或 error） - 用
assertTrue(…)检查业务逻辑是否正确——不成立则标记为失败 - 一旦某个
assume不通过，当前测试方法会立即终止，后续代码不再执行
常用 assume 方法（JUnit 5）
JUnit 5 的 org.junit.jupiter.api.Assumptions 提供了多个静态方法：
-
assumeTrue(boolean condition)：条件为 false → 跳过 -
assumeFalse(boolean condition)：条件为 true → 跳过 -
assumingThat(boolean condition, Executable executable)：仅当条件成立时才执行某段逻辑（常用于局部跳过断言或 setup） -
assumeThat(T actual, Matcher<T> matcher)（需搭配 Hamcrest）：更灵活的匹配判断
典型使用场景与示例
场景1：仅在 Linux 下运行的路径相关测试
立即学习“Java免费学习笔记（深入）”；
@Test
void testLinuxOnlyPathHandling() {
Assumptions.assumeTrue("linux".equals(System.getProperty("os.name").toLowerCase()));
// 后续只在 Linux 环境中执行
assertEquals("/home/user", Paths.get("~").toAbsolutePath().toString());
}
场景2：跳过需要 Docker 的集成测试（本地开发时无 Docker）
@Test
void testWithDockerContainer() {
Assumptions.assumeTrue(DockerClientFactory.instance().isDockerAvailable(),
"Docker not available — skipping integration test");
// 启动容器、调用 API...
}
场景3：用 assumingThat 控制部分断言执行
@Test
void testFeatureAvailability() {
String version = System.getProperty("java.version");
Assumptions.assumingThat(version.startsWith("17"),
() -> assertEquals("expected on JDK 17", "value", getNewApiResult()));
// JDK 17 以下不会执行 assertEquals，也不会报错
}
注意事项
- JUnit 4 中对应的是
org.junit.Assume，API 类似但包名和部分方法名不同（如assumeThat需 Hamcrest） - IDE 和构建工具（如 Maven Surefire）会把被跳过的测试计入 “skipped” 统计，不影响构建成功与否
- 不要用 assume 替代真正的条件分支逻辑；它只是测试生命周期的控制开关
- 避免在 @BeforeEach 中大量使用 assume —— 更推荐放在具体@Test内，语义更清晰
