JUnit测试本地(Eclipse)正常，Jenkins中首个通过第二个失败求助

我之前也碰到过一模一样的坑：本地Eclipse跑JUnit测试全绿，一到Jenkins就第一个用例过、第二个挂，提示找不到元素，加了显式等待也没用。后来排查下来，都是本地和CI环境的差异在搞鬼，给你几个亲测有效的思路：

1. 先查Jenkins的无头浏览器配置 #

大部分Jenkins跑UI测试用的是无头模式（比如Chrome Headless），这玩意儿的视口大小、渲染逻辑和本地正常浏览器天差地别，经常导致元素被挤到看不见或者布局错乱：

• 强制把无头浏览器的分辨率改成和本地一致，比如：

  ChromeOptions options = new ChromeOptions();
  options.addArguments("--headless=new");
  options.addArguments("--window-size=1920,1080"); // 改成你本地常用的分辨率
  options.addArguments("--enable-javascript"); // 确保JS正常执行，无头模式偶尔会禁用这个
  WebDriver driver = new ChromeDriver(options);
  

2. 升级你的等待逻辑，别只等“可见” #

wait.until(ExpectedConditions.visibilityOfElementLocated(...))有时候真的不够——元素可能已经显示在DOM里，但还没加载完成到可交互状态。试试这些更靠谱的等待：

• 等元素可点击：wait.until(ExpectedConditions.elementToBeClickable(By.id("target-element")))
• 等页面完全加载：监听document.readyState确保所有资源都加载完：

  wait.until(driver -> ((JavascriptExecutor) driver).executeScript("return document.readyState").equals("complete"));
  

• 应急的话，可以在第二个测试用例前加个短暂的Thread.sleep(3000)（别骂，先确认是不是加载慢的问题，再换成优雅的显式等待）

3. 检查测试用例的隔离性 #

第一个测试用例跑完后，会不会留下了Cookie、本地存储或者页面跳转的状态？导致第二个用例的初始环境和本地不一样：

• 用@BeforeEach注解在每个测试前重置浏览器：比如driver.manage().deleteAllCookies()、driver.navigate().to(baseUrl)，确保每个用例都从干净的状态开始。

4. 给Jenkins加失败截图，直观排查 #

这是最管用的！在测试失败时自动截图，看看Jenkins里实际的页面到底是什么样子——说不定第二个用例执行时页面根本没跳对，或者元素被弹窗挡住了：

@AfterEach
public void tearDown(ITestResult result) {
    if (result.getStatus() == ITestResult.FAILURE) {
        File screenshot = ((TakesScreenshot) driver).getScreenshotAs(OutputType.FILE);
        // 把截图存到Jenkins工作目录，构建完就能看
        try {
            FileUtils.copyFile(screenshot, new File("target/screenshots/failure_" + System.currentTimeMillis() + ".png"));
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
    driver.quit();
}

5. 排查Jenkins的网络环境 #

Jenkins服务器的网络可能比本地慢，或者有代理、防火墙导致页面资源加载超时。可以加个日志打印页面加载时间，或者开启浏览器性能日志看资源加载情况：

LoggingPreferences logPrefs = new LoggingPreferences();
logPrefs.enable(LogType.PERFORMANCE, Level.ALL);
ChromeOptions options = new ChromeOptions();
options.setCapability(CapabilityType.LOGGING_PREFS, logPrefs);

然后在测试中打印性能日志，看看有没有CSS、JS加载失败的情况。

按这个顺序排查，大概率能找到问题——我当时就是因为无头浏览器视口太小，元素被挤到页面外面了，改了分辨率就好了。

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