asserttimeout 通过执行传入的 executable 并在指定时间内检查其是否完成来断言超时。如果代码在时限内正常结束，断言成功；若超过时限仍未结束，则抛出 assertionerror 并标记测试失败。使用时需明确指定时长单位（如秒、毫秒）并提供具体的业务逻辑代码块。
如何设置超时时间与执行逻辑
调用 Assertions.assertTimeout(Duration, Executable) 方法即可实现。你需要构造一个 Duration 对象定义时间上限，并将需要测试的代码放入 lambda 表达式或 Runnable 中。该方法会启动一个子线程运行这段代码，主线程等待结果。只要代码在规定时间内返回，测试即通过；否则直接中断并报错。
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertTimeout;
import java.time.Duration;
public class TimeoutTest {
@Test
public void testFastOperation() {
// 断言代码在 500 毫秒内完成
assertTimeout(Duration.ofMillis(500), () -> {
// 模拟快速操作
Thread.sleep(100);
});
}
}
上述代码中，Thread.sleep(100) 耗时远小于 500 毫秒，因此测试会通过。若将睡眠时间改为 600 毫秒，assertTimeout 会在 500 毫秒时强制终止线程并抛出异常，导致测试失败。
如何处理超时后的自定义消息
当默认的错误信息不足以定位问题时，可以使用重载版本 assertTimeout(Duration, Executable, String message)。第三个参数是一个字符串，用于在超时发生时作为 AssertionError 的详细消息输出。这有助于在复杂的测试套件中快速识别是哪个具体的超时断言失败了，以及预期的行为是什么。
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.assertTimeout;
import java.time.Duration;
public class TimeoutWithMessageTest {
@Test
public void testSlowOperationWithMessage() {
// 断言代码在 100 毫秒内完成，失败时提示具体原因
assertTimeout(Duration.ofMillis(100), () -> {
Thread.sleep(200); // 故意超时
}, "数据库查询不应超过 100ms");
}
}
在此示例中，由于 Thread.sleep(200) 超过了设定的 100 毫秒限制，测试将失败，控制台输出的错误信息中将包含 “数据库查询不应超过 100ms” 这一自定义描述，方便开发者排查性能瓶颈。
超时后抛出的异常类型与处理机制
当 assertTimeout 检测到执行超时时，它不会让测试线程无限期挂起，而是会立即中断正在运行的 Executable 任务，并向上层抛出 org.opentest4j.AssertionFailedError。这个异常是 JUnit 5 标准断言失败的标准形式，其中包含了你提供的自定义消息（如果有）。需要注意的是，被中断的任务线程可能会因为 InterruptedException 而停止，但这对测试本身的断言结果没有影响，因为断言关注的是“是否在限定时间内完成”这一事实，而不是任务内部的具体异常栈。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
