java单元测试超时设置核心是junit 4用@test(timeout=毫秒)、junit 5用@timeout注解，均不中断线程仅标记失败，适用于同步阻塞场景，但无法终止后台线程，需配合业务层显式超时与可取消设计。
Java 单元测试中设置超时时间，核心是用 @Test 注解的 timeout 参数（JUnit 4）或 @Timeout 注解（JUnit 5），目的是防止测试因阻塞、死循环或未响应的异步调用而无限挂起。
JUnit 4：用 @Test(timeout = 毫秒数)
这是最常用的方式，直接在测试方法上添加参数：
- 单位固定为毫秒，例如
@Test(timeout = 2000)表示最多运行 2 秒 - 超时后测试自动失败，并抛出
org.junit.internal.AssumptionViolatedException或类似超时异常（非中断线程，仅标记失败） - 不适用于真正需要取消后台线程的场景——比如一个
while(true)循环仍在运行，它不会被终止，只让当前测试方法结束 - 适合简单同步阻塞或忘记加超时的 Future.get() 等情况
JUnit 5：用 @Timeout 注解（更灵活）
JUnit 5 将超时支持升级为独立注解，语义更清晰、单位更丰富：
- 支持多种时间单位：
@Timeout(value = 3, unit = TimeUnit.SECONDS)，也支持MILLISECONDS、NANOSECONDS等 - 可作用于单个方法（推荐）或整个测试类（类级超时对所有方法生效）
- 同样不中断线程，超时后抛出
AssertionFailedError，测试标记为失败 - 配合现代异步编程（如
CompletableFuture、Mono.timeout()）使用效果更好，但需注意：它只管测试方法执行时长，不管异步任务是否真正完成
关键注意事项
超时机制不是“万能熔断器”，实际使用中要避开几个常见误区：
- 它不会杀死正在运行的子线程或 ExecutorService 中的任务，资源泄漏风险仍存在。建议异步逻辑本身带可取消设计（如用
Future.cancel(true)或ExecutorService.shutdownNow()） - 不要依赖超时来替代代码层的显式超时控制。例如调用 HTTP 客户端或数据库操作，应在业务代码里设好连接/读取超时，而不是全靠测试超时兜底
- 超时值不宜设得太短——网络抖动、CI 环境负载高都可能导致误失败；也不宜过长，失去快速反馈意义。建议比正常执行时间多留 2–3 倍余量
- JUnit 4 的
@Rule Timeout方式已基本被弃用，优先使用@Test(timeout = ...)
简单对比示例
同一逻辑在两个版本中的写法差异：
- JUnit 4：
@Test(timeout = 1500) public void testApiCall() { ... } - JUnit 5：
@Test @Timeout(value = 1, unit = TimeUnit.SECONDS) public void testApiCall() { ... }
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
