@Timeout 是 JUnit 5 中用于限制测试执行时长的注解，支持方法级和类级配置，单位灵活（如秒、毫秒），超时则中断线程并抛出 TimeoutException；它非性能断言替代品，仅作安全兜底。
@Timeout 是 JUnit 5 中用于控制单个测试方法执行时长的注解，它能防止测试因死循环、阻塞或外部依赖响应慢而无限挂起，提升 CI/CD 流程稳定性。
基本用法：指定毫秒级超时阈值
直接在 @Test 方法上添加 @Timeout，单位默认是秒（java.time.Duration 支持更清晰的表达）：
- 写法一（推荐，语义明确）：
@Timeout(value = 2, unit = ChronoUnit.SECONDS) - 写法二（简写，默认单位为秒）：
@Timeout(2) - 写法三（毫秒）：
@Timeout(value = 2000, unit = ChronoUnit.MILLIS)
一旦测试执行时间超过设定值，JUnit 5 会立即中断该测试线程，并标记为失败（抛出 org.junit.jupiter.api.TimeoutException）。
作用范围支持类级别和方法级别
@Timeout 可用于：
JavaStoryDevelop
下载
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
- 单个测试方法（最常用）：限制该方法执行上限
- 整个测试类：对类中所有测试方法统一设限（需加在类声明上）
注意：类级 @Timeout 不会覆盖方法级设置——如果某方法单独标注了更短的超时时间，以该方法的为准。
与 JUnit 4 的 timeout 参数本质不同
JUnit 4 的 @Test(timeout = 1000) 是内置参数，而 JUnit 5 的 @Timeout 是独立注解，设计更灵活：
- 支持任意时间单位（纳秒、毫秒、秒、分钟等），借助
ChronoUnit - 可与其他扩展（如
@ExtendWith）共存，不耦合在@Test内部 - 配合
@RepeatedTest或@ParameterizedTest时，每次执行都独立计时
常见陷阱与建议
使用时需注意：
- 超时判定基于「实际运行耗时」，不是 CPU 时间，所以 I/O 等待也会计入
- 不要用
@Timeout替代性能断言；它只是安全兜底，不能替代assertThat(...).isLessThan(...)类的验证 - 本地调试时若频繁超时，优先检查逻辑是否真存在阻塞，而非盲目调大阈值
- 在 CI 环境中建议设得比本地略宽松（例如多留 20%），避免因机器负载波动误报
