Selenium 升级至 4.8.3 后，Actions.moveToElement(webElement, x, y) 在非 100% 缩放页面下常出现悬停偏移或完全失效，根本原因在于 ChromeDriver 对缩放因子（zoom）的坐标计算未做适配，需通过重置浏览器缩放或改用相对坐标策略解决。
selenium 升级至 4.8.3 后，`actions.movetoelement(webelement, x, y)` 在非 100% 缩放页面下常出现悬停偏移或完全失效，根本原因在于 chromedriver 对缩放因子（zoom）的坐标计算未做适配，需通过重置浏览器缩放或改用相对坐标策略解决。
在 Selenium 4 中，Actions.moveToElement() 的行为并未发生本质变更，但其底层坐标计算逻辑对浏览器缩放（zoom level）变得更为敏感——尤其在 Chrome + ChromeDriver 组合中，这是一个长期存在的已知问题（Chromedriver Issue #628）。当页面缩放不为 100%（如 110%、90% 或通过 Ctrl + +/- 手动调整），moveToElement(webElement, xOffset, yOffset) 计算出的像素偏移会因缩放失真而严重偏离目标位置，导致悬停失败或触发错误元素。
✅ 推荐解决方案（按优先级排序）：
-
强制重置浏览器缩放为 100%（最稳定）
在测试初始化阶段执行 JavaScript 命令，确保页面处于标准缩放状态：// Java 示例：重置 Chrome 缩放 JavascriptExecutor js = (JavascriptExecutor) driver; js.executeScript("document.body.style.zoom = '1';"); // 重置 body 缩放 // 或更彻底地重置整个视口（适用于 Chrome） js.executeScript("chrome.runtime.sendMessage('your-extension-id', {action: 'setZoom', zoom: 1});"); // ⚠️ 注意：纯 JS `zoom` 属性仅影响渲染，不改变 `window.devicePixelRatio`；若需彻底生效，建议启动 Chrome 时禁用缩放： ChromeOptions options = new ChromeOptions(); options.addArguments("--force-device-scale-factor=1"); options.addArguments("--disable-visual-refresh"); -
改用 moveByOffset() 配合 moveToElement() 定位基准点（规避缩放干扰）
先将鼠标移动到元素中心，再使用相对偏移（该方式受缩放影响较小）：WebElement webElement = driver.findElement(by); Actions actions = new Actions(driver); // 第一步：移动到元素中心（无偏移） actions.moveToElement(webElement).perform(); // 第二步：基于当前鼠标位置向右偏移（x 方向），保持 y 不变 int xOffset = webElement.getSize().width - 2; int yOffset = 0; // 因已在中心，y 方向无需再偏移 actions.moveByOffset(xOffset, yOffset).perform(); // ⚠️ 注意：moveByOffset 后需调用 reset() 或 moveToElement(null) 清除偏移累积（Selenium 4.8+ 已优化，但仍建议显式重置） actions.moveByOffset(-xOffset, -yOffset).perform(); // 可选：回正鼠标位置
-
使用 W3C Actions API 显式指定坐标系（高级场景）
Selenium 4 默认启用 W3C 协议，可结合 PointerInput 实现像素级精确控制（需配合 getRect() 获取绝对坐标）：WebElement el = driver.findElement(by); Rectangle rect = el.getRect(); Point center = new Point(rect.x + rect.width / 2, rect.y + rect.height / 2); Point target = new Point(rect.x + rect.width - 2, rect.y + rect.height / 2); PointerInput source = new PointerInput(PointerInput.Kind.MOUSE, "mouse"); Sequence sequence = new Sequence(source, 0) .addAction(source.createMove(Duration.ofMillis(0), target.x, target.y)) .addAction(source.createPointerDown(PointerInput.MouseButton.LEFT.asArg())) .addAction(source.createPointerUp(PointerInput.MouseButton.LEFT.asArg())); driver.perform(Arrays.asList(sequence));
? 关键注意事项：
- 不要依赖 Dimension.getSize() 返回的宽高直接用于 moveToElement(..., x, y) —— 缩放下该尺寸与实际渲染像素不一致；
- 避免在远程执行环境（如 Selenoid）中动态调整缩放，因其可能被容器策略覆盖；
- 若必须支持多缩放测试，请优先采用 moveByOffset() + moveToElement(webElement) 组合，并在测试前校验 window.visualViewport.scale 是否为 1；
- Selenium 4.11+ 已增强对 moveToElement 的兼容性，建议升级至最新稳定版并搭配 ChromeDriver 120+ 使用。
综上，悬停失效并非 Selenium 4 的“新 Bug”，而是旧有缩放适配缺陷在新版中暴露更明显。通过统一缩放环境或切换为更鲁棒的坐标策略，即可可靠实现精准悬停操作。
