无法生成Cucumber报告及触发邮件：Selenium元素定位失败

错误信息 #

[ERROR] Failed to execute goal org.codehaus.mojo:exec-maven-plugin:3.0.0:java (mail-execution) on project qa-automation: An exception occured while executing the Java class. no such element: Unable to locate element: {"method":"xpath","selector":"//*[@id=\"featureChartCarousel\"]/ol/li[1]"}
[ERROR]   (Session info: headless chrome=108.0.5359.124)
[ERROR] For documentation on this error, please visit: https://selenium.dev/exceptions/#no_such_element
[ERROR] Build info: version: '4.1.2', revision: '9a5a329c5a'
[ERROR] System info: host: 'ip-10-0-1-80', ip: '127.0.0.1', os.name: 'Linux', os.arch: 'amd64', os.version: '5.4.0-1092-aws', java.version: '1.8.0_352'
[ERROR] Driver info: org.openqa.selenium.chrome.ChromeDriver
[ERROR] Command: [f0b38831845245c963309f6da8c906c1, findElement {using=xpath, value=//*[@id=\"featureChartCarousel\"]/ol/li[1]}]
[ERROR] Capabilities {acceptInsecureCerts: false, browserName: chrome, browserVersion: 108.0.5359.124, chrome: {chromedriverVersion: 108.0.5359.71 (1e0e3868ee06..., userDataDir: /tmp/.com.google.Chrome.WmdU7j}, goog:chromeOptions: {debuggerAddress: localhost:32925}, javascriptEnabled: true, networkConnectionEnabled: false, pageLoadStrategy: normal, platform: LINUX, platformName: LINUX, proxy: Proxy(), se:cdp: ws://localhost:32925/devtoo..., se:cdpVersion: 108.0.5359.124, setWindowRect: true, strictFileInteractability: false, timeouts: {implicit: 0, pageLoad: 300000, script: 30000}, unhandledPromptBehavior: dismiss and notify, webauthn:extension:credBlob: true, webauthn:extension:largeBlob: true, webauthn:virtualAuthenticators: true}
[ERROR] Session ID: f0b38831845245c963309f6da8c906c1

排查与解决步骤 #

1. 确认Cucumber报告是否实际生成 #

• 检查报告输出目录（通常为target/cucumber-reports），确认存在完整的HTML/JSON格式报告文件。
• 若报告未生成，先排查Cucumber插件配置：
  • 验证pom.xml中cucumber-maven-plugin的outputDirectory路径配置正确。
  • 查看测试执行日志，确认所有用例正常完成，无中途失败导致报告终止生成的情况。

2. 解决Selenium元素未找到问题（即使XPath正确） #

• 添加显式等待：在查找元素前等待元素加载完成，避免页面渲染延迟影响：

  WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(10));
  WebElement targetElement = wait.until(ExpectedConditions.visibilityOfElementLocated(
      By.xpath("//*[@id=\"featureChartCarousel\"]/ol/li[1]")
  ));
  

• 调整无头Chrome窗口尺寸：无头模式默认窗口较小，可能导致元素不可见，启动时添加参数：

  ChromeOptions options = new ChromeOptions();
  options.addArguments("--headless=new");
  options.addArguments("--window-size=1920,1080");
  WebDriver driver = new ChromeDriver(options);
  

• 验证报告页面结构：直接打开生成的报告HTML文件，检查是否存在id="featureChartCarousel"的元素，确认页面结构未发生变更。
• 无头模式截图排查：通过截图查看页面实际渲染状态，确认元素是否被遮挡或未加载：

  File screenshot = ((TakesScreenshot) driver).getScreenshotAs(OutputType.FILE);
  FileUtils.copyFile(screenshot, new File("report-render-screenshot.png"));
  

3. 确认Maven任务执行顺序 #

• 确保Cucumber报告生成任务（如cucumber:report）在邮件触发任务（exec:java）之前执行。
• 在pom.xml中明确绑定插件到正确的Maven阶段，示例配置：

  <plugin>
      <groupId>io.cucumber</groupId>
      <artifactId>cucumber-maven-plugin</artifactId>
      <version>7.11.0</version>
      <executions>
          <execution>
              <id>generate-report</id>
              <phase>verify</phase>
              <goals>
                  <goal>report</goal>
              </goals>
          </execution>
      </executions>
  </plugin>
  <plugin>
      <groupId>org.codehaus.mojo</groupId>
      <artifactId>exec-maven-plugin</artifactId>
      <version>3.0.0</version>
      <executions>
          <execution>
              <id>mail-execution</id>
              <phase>post-integration-test</phase>
              <goals>
                  <goal>java</goal>
              </goals>
          </execution>
      </executions>
  </plugin>
  

4. 日志深度排查 #

• 查看Cucumber测试的完整日志，确认报告生成过程无异常。
• 查看邮件执行模块的日志，确认是否因报告文件缺失导致后续Selenium操作失败。

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