Jenkins上Selenium Java测试的重试机制实现及流水线配置问题

一、Jenkins流水线关联代码仓库修复 #

你的流水线快速完成无操作，核心原因是没有拉取测试代码仓库，导致ant compile和ant runTests没有可处理的文件。需要在流水线中添加代码拉取步骤，以下是Git仓库的修改示例（如果是SVN等其他仓库，替换对应scm步骤即可）：

修改后的Pipeline脚本：

pipeline {
    agent any
    
    stages {
        stage('Checkout Code') {
            steps {
                // 替换为你的Git仓库地址和凭据ID（私有仓库需配置）
                git url: 'https://your-git-repo-url.git', credentialsId: 'your-git-credential-id', branch: 'main'
            }
        }
        
        stage('Build') {
            steps {
                sh 'ant compile'
            }
        }
        
        stage('Run Tests') {
            steps {
                // 优先用TestNG层面的重试，Jenkins重试可作为兜底（可选）
                sh 'ant runTests'
            }
        }
    }
    
    // 可选：TestNG重试后仍失败时，Jenkins层面重试整个套件（不推荐，效率较低）
    // post {
    //     failure {
    //         retry(2) {
    //             sh 'ant runTests'
    //         }
    //     }
    // }
}

说明：

• Checkout Code阶段是核心，负责拉取测试代码到Jenkins代理节点
• 私有仓库需在Jenkins中配置Git凭据（用户名/密码或SSH密钥），并填写对应的credentialsId
• 确保代码仓库根目录存在正确的build.xml文件，否则ant命令会执行失败

二、TestNG实现单个测试用例自动重试（推荐方案） #

针对Selenium测试的间歇性超时失败，TestNG层面的单个用例重试比Jenkins整个套件重试更高效，只会重试失败的用例，不会重复执行已通过的测试。

方案1：实现IRetryAnalyzer接口（基础版） #

编写重试逻辑类，控制重试次数和触发条件（仅针对环境/超时类异常，避免重试功能bug）：

import org.testng.IRetryAnalyzer;
import org.testng.ITestResult;
import org.openqa.selenium.TimeoutException;
import org.openqa.selenium.NoSuchElementException;

public class RetryAnalyzer implements IRetryAnalyzer {
    private int retryCount = 0;
    private static final int MAX_RETRY = 3; // 最多重试3次

    @Override
    public boolean retry(ITestResult result) {
        if (retryCount < MAX_RETRY) {
            Throwable cause = result.getThrowable();
            // 只重试元素未加载、超时这类环境相关异常
            if (cause instanceof TimeoutException || cause instanceof NoSuchElementException) {
                retryCount++;
                return true;
            }
        }
        return false;
    }
}

在测试用例的@Test注解中指定重试类：

import org.testng.annotations.Test;

public class SeleniumTestCases {
    @Test(retryAnalyzer = RetryAnalyzer.class)
    public void testUserLogin() {
        // 你的Selenium测试逻辑
    }
}

方案2：结合IAnnotationTransformer实现全局重试（进阶版） #

如果测试用例数量多，不想逐个添加retryAnalyzer，可以用IAnnotationTransformer全局注入重试逻辑：

import org.testng.IAnnotationTransformer;
import org.testng.annotations.ITestAnnotation;
import java.lang.reflect.Constructor;
import java.lang.reflect.Method;

public class RetryListener implements IAnnotationTransformer {
    @Override
    public void transform(ITestAnnotation annotation, Class testClass, Constructor testConstructor, Method testMethod) {
        if (annotation.getRetryAnalyzer() == null) {
            annotation.setRetryAnalyzer(RetryAnalyzer.class);
        }
    }
}

在TestNG的xml配置文件中添加监听器，实现全局生效：

<!DOCTYPE suite SYSTEM "https://testng.org/testng-1.0.dtd" >
<suite name="SeleniumTestSuite">
    <listeners>
        <listener class-name="com.your.package.RetryListener"/>
    </listeners>
    <test name="AllTests">
        <classes>
            <class name="com.your.package.SeleniumTestCases"/>
        </classes>
    </test>
</suite>

三、额外优化建议（从根源减少间歇性失败） #

除了重试机制，还可以优化Selenium代码降低超时概率：

• 使用显式等待代替隐式等待：针对每个需要等待的元素，用WebDriverWait配合ExpectedConditions

  import org.openqa.selenium.support.ui.WebDriverWait;
  import org.openqa.selenium.support.ui.ExpectedConditions;
  import org.openqa.selenium.By;
  
  // 等待元素可见，最多等待10秒
  WebDriverWait wait = new WebDriverWait(driver, 10);
  wait.until(ExpectedConditions.visibilityOfElementLocated(By.id("username")));
  

• 合理设置WebDriver超时：创建驱动时，配置页面加载超时、脚本执行超时等参数
• 避免硬编码Thread.sleep，改用显式等待更灵活可靠

内容的提问来源于stack exchange，提问作者sneedster