测试用例运行稳定性是自动化质量的一个重要指标,在运行中需要尽可能的剔除非 bug 造成的测试用例执行失败,对于失败用例进行重跑是常用策略之一。一种重跑策略是所有用例运行结束后对失败用例重跑,另一种重跑策略是在运行时监控用例运行状态,失败后实时重跑。
下面,详细介绍 TestNG 如何对失败测试用例实时重跑并解决重跑过程中所遇到问题的实践和解决方案。对失败测试用例进行实时重跑,有以下几个方面需求:
测试用例运行失败,监听到失败后立即进行重跑
测试用例通过 dependsOnMethods/dependsOnGroups 标记依赖其他测试用例,在被依赖的测试用例重跑运行成功后,该测试用例可以继续运行
对于重跑多次的测试用例,只记录最后一次运行成功或失败结果
一、测试用例重跑
1.1 retryAnalyzer 注解方式
对于希望测试用例中的少量易失败,不稳定的测试用例进行重跑,可采用这种方式。
1.1.1 原理
以下是 TestNG 处理测试用例运行结果的部分代码。
IRetryAnalyzer retryAnalyzer = testMethod.getRetryAnalyzer();
boolean willRetry = retryAnalyzer != null && status == ITestResult.FAILURE && failure.instances != null && retryAnalyzer.retry(testResult);
if (willRetry) {
resultsToRetry.add(testResult);
failure.count++;
failure.instances.add(testResult.getInstance());
testResult.setStatus(ITestResult.SKIP);
} else {
testResult.setStatus(status);
if (status == ITestResult.FAILURE && !handled) {
handleException(ite, testMethod, testResult, failure.count++);
}
复制代码
分析以上代码,其中,接口 IretryAnalyzer 的方法 retry()的返回值作为是否对失败测试用例进行重跑的一个条件。如果 retry()结果为 true,则该失败测试用例会重跑,同时将本次失败结果修改为 Skip;如果结果为 false,则失败的测试用例保持失败结果,运行结束。因此,如果你希望失败测试用例重跑的话,需要把 IretryAnalyzer 的 retry()方法重写,插入自己定义的逻辑,设置返回值为 true。
1.1.2 代码
创建类 RetryImpl,重写 retry()方法,设置失败测试用例的重跑次数,代码如下:
public class RetryImpl implements IRetryAnalyzer {
private int count = 1;
private int max_count = 3; // Failed test cases could be run 3 times at most
@Override
public boolean retry(ITestResult result) {
System.out.println("Test case :"+result.getName()+",retry time: "+count+"");
if (count < max_count) {
count++;
return true;
}
return false;
}
}
复制代码
1.1.3 实例
public class TestNGReRunDemo {
@Test(retryAnalyzer=RetryImpl.class)
public void test01(){
Assert.assertEquals("success","fail");
System.out.println("test01");
}
}
复制代码
以上测试用例 test01 可重复运行 3 次。
1.2 实现接口 IAnnotationTransformer 方式
如果希望所有失败的测试用例都进行重跑,采用 retryAnalyzer 注解方式对每个测试用例进行注解就比较麻烦。通过实现 IAnnotationTransformer 接口的方式,可以对全量测试用例的重试类进行设置。该接口是一个监听器接口,用来修改 TestNG 注解。IAnnotationTransformer 监听器接口只有一个方法:transform(ITestAnnotation annotation, Class testClass, Constructor testConstructor, Method testMethod). 上文中,我们自定义了类 RetryImpl 实现接口 IRetryAnalyzer。TestNG 通过 transfrom()方法修改 retryAnalyzer 注解。以下代码对 retryAnalyzer 注解进行修改设置。
1.2.1 代码
创建类 RetryListener,代码如下。
public class RetryListener implements IAnnotationTransformer {
public void transform(ITestAnnotation annotation, Class testClass, Constructor testConstructor, Method testMethod) {
IRetryAnalyzer retry = annotation.getRetryAnalyzer();
if (retry == null) {
annotation.setRetryAnalyzer(RetryImpl.class);
}
}
}
复制代码
1.2.2 配置 Listener
TestNG 可以在配置文件或者测试类中对Listener
类进行配置。
@Listeners({RetryListener.class})
public class TestNGReRunDemo {
@Test
public void test01(){
Assert.assertEquals("success","fail");
System.out.println("test01");
}
}
复制代码
配置完成后,运行测试用例 test01,运行结果显示 test01 将重跑次数 3 次。
二、被依赖的测试用例重跑结果处理
进一步分析 TestNG 的运行代码,其在对失败运行用例重跑时,逻辑如下图。
对于通过 dependsOnMethods 或 dependsOnGroups 注解依赖于其他测试用例的测试用例来讲 ,测试用例执行分为两种情况:
2.1 场景分析:场景一
被依赖的测试用例失败后进行了重跑,并重跑成功。(注:在 RetryImpl 类中,已设置最大重跑次数 max_count = 3)
public static int number =0;
@Test
public void test01(){
number++;
System.out.println(String.valueOf(number));
Assert.assertEquals(number,2);
System.out.println("test01");
}
@Test(dependsOnMethods = "test01") // alwaysRun = false by default
public void test02(){
System.out.println("test02 is running only if test01 is passed.");
}
复制代码
1、TestNG 测试报告
2、问题
测试用例 | 运行次数 | 运行情况 | 测试报告 |
---|
Test01 | 2 | 第一次:skipped ; 第二次:passed | 在Skipped 和Passed的统计数量中,test01被分别记录一次 |
Test02 | 0 | Skipped | 记录一次Skipped |
2.2 场景分析:场景二
被依赖的测试用例失败后进行了重跑,并且重跑没有成功。(注:在 RetryImpl 类中,已设置最大重跑次数 max_count = 3)
public static int number =0;
@Test
public void test01(){
number++;
System.out.println(String.valueOf(number));
Assert.assertEquals(number,10);
System.out.println("test01");
}
@Test(dependsOnMethods = "test01") // alwaysRun = false by default
public void test02(){
System.out.println("test02 is running only if test01 is passed.");
}
复制代码
1、TestNG 测试报告
2、问题
测试用例 | 运行次数 | 运行结果 | 测试报告 |
---|
Test01 | 3 | 第一次:skipped;第二次:skipped;第三次:failed | 在Skipped统计数量中,test01被被记录两次在failed统计中,test01被记录一次 |
Test02 | 0 | Skipped | 记录一次Skipped |
三、优化解决方案
以下方案解决重跑测试用例成功后后继测试用例无法继续运行的问题,并对测试报告进行优化。
3.1 TestListenerAdapter 方法重写
根据上面分析的 TestNG 逻辑,在对依赖测试用例的结果进行检查如果忽略重跑的中间结果只检查最后一次的运行结果,可以达到需求的。对于测试报告,同样的处理方式,忽略所有中间的测试用例运行结果,只记录最后结测试用例的中间运行结果为 Skipped,下面的代码通过重写 TestListenerAdapter 的 onTestSuccess()和 onTestFailure()方法,对测试用例的中间结果 skipped 进行了。代码如下:
public class ResultListener extends TestListenerAdapter {
@Override
public void onTestFailure(ITestResult tr) {
if(tr.getMethod().getCurrentInvocationCount()==1)
{
super.onTestFailure(tr);
return;
}
processSkipResult(tr);
super.onTestFailure(tr);
}
@Override
public void onTestSuccess(ITestResult tr) {
if(tr.getMethod().getCurrentInvocationCount()==1)
{
super.onTestSuccess(tr);
return;
}
processSkipResult(tr);
super.onTestSuccess(tr);
}
// Remove all the dup Skipped results
public void processSkipResult(ITestResult tr)
{
ITestContext iTestContext = tr.getTestContext();
Iterator<ITestResult> processResults = iTestContext.getSkippedTests().getAllResults().iterator();
while (processResults.hasNext()) {
ITestResult skippedTest = (ITestResult) processResults.next();
if (skippedTest.getMethod().getMethodName().equalsIgnoreCase(tr.getMethod().getMethodName()) ) {
processResults.remove();
}
}
}
}
复制代码
3.2 配置结果处理 Listener 类
在配置文件进行全局设置或者在测试类中标记。
3.3 场景一
1、 结果验证
2、结果分析:
测试用例 | 运行次数 | 运行结果 | 测试报告 |
---|
Test01 | 2 | 第一次:skipped;第二次:passed | 只在Passed的统计数量中test01被记录一次 |
Test02 | 1 | Passed | 记录一次passed |
3.4 场景二
1、结果验证
2、结果分析:
测试用例 | 运行次数 | 运行结果 | 测试报告 |
---|
Test01 | 3 | 第一次:skipped;第二次:skipped;第三次:failed | test01只在failed统计中被记录一次 |
Test02 | 1 | Skipped | 依赖用例执行失败,test02结果为Skipped,只记录一次结果Skipped |
本文转载自公众号宜信技术学院(ID:CE_TECH)。
原文链接:
https://mp.weixin.qq.com/s/PLF-1RXbMPU1mWpOwiSamA
评论