AssertTimeout 是 JUnit 5 用于验证代码执行时长是否超时的断言工具，通过中断线程实现超时检测，要求被测代码响应中断；支持 preemptive（默认）和 failingFast 策略，需避免吞掉 InterruptedException 或使用非中断友好操作。
AssertTimeout 是 JUnit 5 提供的用于验证代码执行时长是否在预期范围内的断言工具，它不依赖于线程休眠或外部计时器，而是通过中断执行线程来强制超时检测，适合测试对响应时间敏感的逻辑（如网络调用、算法性能边界等）。
基本用法：静态方法调用
最常用的方式是使用 AssertTimeout.ofSeconds() 或 ofMillis() 配合 lambda 表达式：
- 传入一个时间阈值（如 100 毫秒），以及一个
Executable（即无参无返回值的函数式接口） - 若代码块在指定时间内完成，测试通过；超时则抛出
AssertionFailedError，测试失败 - 注意：被测代码需能响应中断（例如使用
Thread.sleep()、Object.wait()或支持中断的 I/O 操作），否则可能无法及时终止
示例：
@Test
void testSlowOperationShouldFinishWithin100ms() {
AssertTimeout.ofMillis(100).assertTimeout(() -> {
Thread.sleep(50); // 正常情况应成功
});
}
支持预设超时策略
JUnit 5 提供了三种预定义策略，可通过 AssertTimeout.preemptive() 或 AssertTimeout.failingFast() 显式指定：
-
preemptive()（默认）：启动独立监控线程，在超时时主动中断被测线程 -
failingFast()：不中断线程，仅等待并检查是否超时——适用于不能被中断的场景（如 native 调用），但无法强制终止长时间运行任务 - 也可直接使用
AssertTimeout.of(...).withExtension(...)自定义行为（较少用）
常见陷阱与注意事项
使用 AssertTimeout 时容易忽略的关键点：
- 不要在超时断言中执行非中断友好操作（如
while(true)循环且无Thread.interrupted()检查），会导致测试挂起 - 避免在被测代码中捕获并吞掉
InterruptedException，否则中断信号失效 - 超时值不宜设得过小（尤其在 CI 环境下受负载影响），建议预留合理缓冲，或结合
@RepeatedTest做稳定性验证 - 它不是性能分析工具，不提供耗时统计；如需记录实际执行时间，请改用
System.nanoTime()手动测量
替代方案参考
如果 AssertTimeout 不满足需求，可考虑：
- 使用
@Timeout注解（作用于整个测试方法，更简洁，但粒度较粗） - 手动计时 +
assertTrue(elapsed <= threshold)（完全可控，但需自行处理异常和资源清理） - 第三方库如
awaitility（适合异步/条件等待场景）
不复杂但容易忽略细节，关键是让被测逻辑对中断有响应能力。
