@timeout 是测试执行时间监控而非异步超时控制，junit 4 需配合 timeout 规则，junit 5 支持原生注解和多单位；它不中断线程，仅抛异常标记失败，可靠异步测试需代码层显式超时与资源清理。
在 JUnit 中，@Timeout 可以用来限制单个测试方法的执行时长，避免因异步操作未完成（比如回调未触发、Future 未返回、线程阻塞等）导致测试卡死或超长等待。但要注意：JUnit 4 的 @Timeout 和 JUnit 5 的 @Timeout 行为不同，且对异步逻辑的支持有天然局限——它不能中断正在运行的线程，而是通过抛出异常来标记超时失败。
JUnit 4 中使用 @Timeout（类级或方法级）
JUnit 4 的 @Timeout 是一个 @Rule 级注解，需配合 Timeout 规则使用，作用于整个测试方法：
- 它会在测试方法开始后启动计时器，超时则抛出
TimeoutException，并终止该测试方法的执行（但不会强制中断底层线程） - 适用于简单场景，如调用一个可能阻塞的异步方法但未做超时控制（例如未设置
Future.get(5, TimeUnit.SECONDS)） - 示例：
@Test
@Timeout(millis = 3000)
public void testAsyncCallWithoutExplicitTimeout() {
CompletableFuture<string> future = asyncService.doSomething();
// 忘记 .get(2, SECONDS)，直接 .get() —— 这里可能永久阻塞
String result = future.join(); // 或 future.get()
assertNotNull(result);
}</string>
⚠️ 注意：如果异步任务本身在独立线程中无限循环（如 while(true) {...}），@Timeout 不会杀死该线程，只让测试方法失败。资源泄漏风险仍存在，需配合可取消的异步设计（如使用 ExecutorService + shutdownNow()）。
JUnit 5 中使用 @Timeout（更灵活，支持多种单位）
JUnit 5 将 @Timeout 升级为原生注解，支持方法级和类级，并提供更清晰的语义：
- 语法简洁：
@Timeout(value = 5, unit = TimeUnit.SECONDS) - 默认单位是秒，也支持纳秒、毫秒等；支持
@Timeout(5)（即 5 秒） - 同样不中断线程，仅在超时时让测试失败并抛出
AssertionFailedError - 适合与现代异步 API 配合，例如
CompletableFuture、Mono/Flux（需额外验证响应状态）
@Test
@Timeout(value = 2, unit = TimeUnit.SECONDS)
void testWithCompletableFuture() {
CompletableFuture<string> future = service.fetchDataAsync();
// 正确做法仍是显式带超时的 get，@Timeout 是兜底
String result = future.orTimeout(1, TimeUnit.SECONDS).join();
assertEquals("expected", result);
}</string>
真正可靠的异步测试：@Timeout 是兜底，不是替代方案
@Timeout 的本质是“测试执行时间监控”，而非“异步操作超时控制”。要防止无限等待，关键仍在代码层：
- 所有阻塞式异步调用（如
Future.get()、CountDownLatch.await()、BlockingQueue.take()）必须显式指定超时参数 - 使用响应式流（Reactor / RxJava）时，统一用
timeout()操作符，而不是依赖测试框架 - 若测试中启用了线程池，建议在
@AfterEach中调用executor.shutdownNow()清理资源 - 对回调型异步（如监听器模式），可用
CountDownLatch+ 显式await(3, SECONDS)，比@Timeout更可控
替代方案：用 assertTimeout 或 assertTimeoutPreemptively（JUnit 5.8+）
JUnit 5.8 引入了更明确的断言式超时工具，推荐优先使用：
-
Assertions.assertTimeout(Duration.ofSeconds(3), () -> { ... });：超时则失败，但不中断执行 -
Assertions.assertTimeoutPreemptively(Duration.ofSeconds(3), () -> { ... });：超时后尝试中断执行线程（对可中断操作有效，如Thread.sleep()、Object.wait()、BlockingQueue.poll()） - 它们比
@Timeout更清晰表达意图，且可嵌套在复杂逻辑中（比如只对某段异步调用设超时）
@Test
void testWithPreemptiveTimeout() {
assertTimeoutPreemptively(Duration.ofSeconds(2), () -> {
CompletableFuture<string> future = slowAsyncOperation();
// 这里若 future 内部不可中断，仍可能无法及时终止
String result = future.get(); // 注意：get() 本身不可中断，应改用 orTimeout().join()
assertEquals("done", result);
});
}</string>
不复杂但容易忽略：超时机制治标不治本，真正的健壮性来自异步调用本身的可取消性与超时配置。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
