junit5支持通过元注解创建自定义组合注解，如@fasttest封装@test和@timeout，统一测试规范；需用@target、@retention声明，可固化高频策略，但不支持继承且ide可能不高亮超时行为。
JUnit5 支持通过元注解（meta-annotation）机制创建自定义组合注解，把多个常用注解（如 @Test 和 @Timeout）封装成一个简洁、可复用的注解。这种方式能统一测试规范，避免重复声明，尤其适合团队约定超时策略或特定测试类型。
自定义组合注解的基本结构
组合注解本质是一个被其他注解修饰的注解，需满足：
- 使用 @Target 指定适用位置（通常是 METHOD）
- 使用 @Retention(RetentionPolicy.RUNTIME) 确保运行时可见
- 必须标注 @Test 和 @Timeout（或其他所需注解）作为元注解
- 不能包含方法体，但可定义属性（如超时值）并传递给底层注解
示例：定义 @FastTest（默认 2 秒超时）
以下是一个典型实现：
@Target(ElementType.METHOD)
@Retention(RetentionPolicy.RUNTIME)
@Test
@Timeout(value = 2, unit = TimeUnit.SECONDS)
public @interface FastTest {
}
使用时直接标注在测试方法上：
@FastTest
void testQuickCalculation() {
assertEquals(4, 2 + 2);
}
该方法等效于同时写 @Test @Timeout(2)，且 IDE 和测试运行器（如 Maven Surefire、IntelliJ）均能正确识别和执行。
支持动态超时值的进阶写法
若需灵活指定不同超时时间，可让组合注解带参数，并通过 Java 的“注解桥接”机制将值透传给 @Timeout。由于 @Timeout 本身不支持参数绑定，需借助 @Repeatable 或扩展机制——但更实用的方式是：**用接口+工厂模式替代纯注解**；或者采用更轻量的约定：
- 定义带 value 参数的组合注解（如
@FastTest(1)），再配合自定义@ExtendWith扩展，在运行时读取该值并注入超时逻辑 - 更推荐做法：保持组合注解简洁，仅固化高频策略（如
@FastTest固定 2s，@SlowTest固定 30s），避免过度复杂化 - 若必须动态，优先使用原生
@Timeout(5)显式声明，比绕路实现更清晰可靠
注意事项与限制
JUnit5 对组合注解有明确约束：
-
@Test方法不能有返回值，所以组合注解标注的方法也必须是void -
@Timeout的unit默认是SECONDS，若需毫秒级，必须显式写unit = TimeUnit.MILLISECONDS - 组合注解不可继承 —— 即父类上的组合注解不会自动应用到子类重写的方法上
- IDE 可能不会高亮显示组合注解中的超时行为，建议搭配文档或团队规范说明
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
