Selenium测试中Actions悬浮在Jenkins Windows节点失效问题排查

以下是你可能遗漏的几个关键点及对应解决方案：

1. 无头模式下的视口与元素可见性问题 #

Jenkins执行测试通常使用浏览器无头模式，默认窗口尺寸极小，目标元素可能不在当前视口内，导致悬浮操作无法触发。

• 先最大化浏览器窗口：

driver.manage().window().maximize();

• 或者滚动到元素可见位置后再执行悬浮：

WebElement element = driver.findElement(By.cssSelector("path to element"));
((JavascriptExecutor) driver).executeScript("arguments[0].scrollIntoView({block: 'center', behavior: 'smooth'});", element);

2. 无头模式的交互兼容性设置 #

旧版无头模式对Actions类的鼠标模拟支持有限，改用新版无头模式并添加必要参数：

ChromeOptions options = new ChromeOptions();
// 启用新版无头模式，支持完整交互能力
options.addArguments("--headless=new");
options.addArguments("--start-maximized");
options.addArguments("--disable-blink-features=AutomationControlled"); // 避免被页面识别为自动化环境
WebDriver driver = new ChromeDriver(options);

3. 替换废弃的MouseEvents事件API #

你使用的document.createEvent('MouseEvents')已被现代浏览器废弃，改用标准的MouseEvent构造函数，同时部分组件会监听mouseenter而非mouseover，建议同时触发两个事件：

String hoverScript = "const mouseOver = new MouseEvent('mouseover', {bubbles: true, cancelable: true, view: window});"
                  + "const mouseEnter = new MouseEvent('mouseenter', {bubbles: false, cancelable: true, view: window});"
                  + "arguments[0].dispatchEvent(mouseOver);"
                  + "arguments[0].dispatchEvent(mouseEnter);";
((JavascriptExecutor) driver).executeScript(hoverScript, element);

4. 确保元素完全加载并可交互 #

Jenkins节点的网络或环境可能导致页面加载较慢，直接执行悬浮会因元素未就绪失败，添加显式等待：

WebDriverWait wait = new WebDriverWait(driver, Duration.ofSeconds(15));
WebElement element = wait.until(ExpectedConditions.visibilityOfElementLocated(By.cssSelector("path to element")));
// 等待元素可交互
wait.until(ExpectedConditions.elementToBeClickable(element));

5. 检查浏览器与驱动版本匹配 #

Jenkins节点上的浏览器版本（如Chrome/Firefox）必须与对应WebDriver（ChromeDriver/GeckoDriver）版本严格一致，版本不匹配会导致Selenium命令执行异常。

6. 解决窗口焦点问题 #

无头模式下浏览器可能未获得焦点，可先让元素获取焦点再执行悬浮：

element.sendKeys(Keys.NULL); // 触发元素焦点
Actions hover = new Actions(driver);
hover.moveToElement(element).perform();

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