自定义注解配合反射控制测试用例执行顺序的核心是“标记+解析+排序+执行”:定义RUNTIME级方法注解(如@TestOrder)、反射扫描并按注解值排序、安全调用排序后的方法,可协同@BeforeEach等生命周期注解使用。
自定义注解配合反射控制测试用例执行顺序,核心在于“标记 + 解析 + 排序 + 执行”。不依赖框架内置机制,而是通过手动扫描方法、读取注解属性、按规则排序后依次调用,实现精确可控的执行流程。
定义带顺序语义的注解
注解需声明为 RUNTIME 保留策略,并限定作用在方法上。关键是要提供可比较的排序依据,比如整数优先级或枚举级别:
-
@TestOrder(int value):最简方式,value 越小越先执行 -
@TestPriority(Priority level):用枚举(如 LOW/MEDIUM/HIGH)提升可读性 -
@TestPhase(String phase):按阶段名字符串排序(如 "setup", "run", "verify", "teardown")
用反射获取并排序被注解的方法
在测试执行器中,通过 Class.getMethods() 或 getDeclaredMethods() 获取全部方法,过滤出带目标注解的,再按注解属性排序:
- 先检查
method.isAnnotationPresent(TestOrder.class) - 用
method.getAnnotation(TestOrder.class).value()提取排序值 - 使用
Arrays.sort(methods, Comparator.comparing(...))排序 - 注意:未标注的方法可默认排在最后,或直接跳过
安全调用排序后的测试方法
排序完成后,遍历方法数组,用反射调用:
- 创建测试类实例:
Object instance = clazz.getDeclaredConstructor().newInstance() - 设为可访问(若方法是 private):
method.setAccessible(true) - 执行:
method.invoke(instance) - 捕获
InvocationTargetException并展开原始异常,便于定位失败原因
与 JUnit 生命周期注解协同使用
可同时支持类似 JUnit 的生命周期控制,例如:
- 定义
@BeforeAll、@AfterAll(类级,各只执行一次) - 定义
@BeforeEach、@AfterEach(方法级,每测试前/后执行) - 这些注解本身不参与顺序排序,而是在执行主测试链前后统一触发
- 例如:先执行所有
@BeforeEach,再按@TestOrder执行测试方法,最后执行对应@AfterEach

















