asserttimeout可精准验证核心逻辑执行时间，仅监控指定代码块、不中断测试、区分超时与业务异常；配合duration设置时限，支持毫秒/秒/分钟等单位；asserttimeoutpreemptively则强制中断超时线程。
用 assertTimeout 可以明确验证一段核心逻辑是否在指定时间内完成，比单纯加 @Timeout 更灵活——它不中断整个测试方法，只监控目标代码块，还能区分“超时失败”和“业务异常”，适合算法类性能验证。
assertTimeout 基本用法
它是 JUnit5 提供的断言方法，属于 org.junit.jupiter.api.Assertions，需配合 Duration 使用。核心逻辑放在 lambda 或方法引用中执行，框架自动计时并判断是否超限。
- 成功：代码块正常结束且耗时 ≤ 设定阈值 → 测试通过
- 失败：代码块未完成且超时 → 抛出
AssertionFailedError，提示“execution exceeded timeout” - 注意：如果代码块内部抛出业务异常（如
IllegalArgumentException），assertTimeout会原样传播该异常，不会误判为超时
验证核心算法执行时间
比如你有一个排序算法实现，要求 10 万数据必须在 200 毫秒内完成：
@Test
void sortLargeArrayWithinTimeLimit() {
int[] data = generateRandomArray(100_000);
assertTimeout(Duration.ofMillis(200), () -> {
quickSort(data); // 被测核心算法
});
}
这段代码只对 quickSort(data) 计时，不影响前后其他准备或校验逻辑。如果排序卡住或太慢，测试立刻失败，并给出精确超时偏差（如“exceeded timeout of 200 ms by 142 ms”）。
搭配 Duration 灵活设时限
JUnit5 的 Duration 支持多种单位，避免手算毫秒数出错：
-
Duration.ofMillis(500)—— 500 毫秒 -
Duration.ofSeconds(2)—— 2 秒 -
Duration.ofMinutes(1)—— 1 分钟 -
Duration.ofNanos(10_000_000)—— 10 百万纳秒（≈10 毫秒）
推荐优先用 ofSeconds 或 ofMillis，语义清晰不易出错。
处理预期中的超时场景
有时你要验证“某个低效算法确实会超时”，可用 assertTimeoutPreemptively 强制中断：
@Test
void inefficientAlgorithmShouldBeInterrupted() {
assertTimeoutPreemptively(Duration.ofMillis(100), () -> {
while (true) { // 故意死循环
Thread.sleep(10);
}
});
}
它会在超时后主动调用 Thread.interrupt()，比普通 assertTimeout 更激进，适合测试中断响应逻辑（如检查 InterruptedException 是否被正确捕获和处理）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
