Firefox59.0.2与Selenium3.11下RemoteWebDriver切换窗口报Missing 'handle'异常求助

我之前维护旧版本Selenium测试套件时也碰到过一模一样的问题，结合当时的排查经验，给你几个实用的解决思路和变通方案：

一、先排查窗口句柄的获取与传递逻辑 #

• 由于RemoteWebDriver涉及客户端和服务端的跨进程通信，句柄获取可能存在延迟，不要直接在触发窗口打开后立即调用getWindowHandles()。建议添加显式等待，确保新窗口的句柄已经被服务端同步：

  // 等待窗口数量变为预期值（比如从1变2）
  new WebDriverWait(driver, 10).until(ExpectedConditions.numberOfWindowsToBe(2));
  Set<String> handles = driver.getWindowHandles();
  

• 打印获取到的句柄集合，确认没有空值或无效字符串。如果句柄列表里存在异常值，大概率是RemoteWebDriver和Firefox节点的通信出了问题，这时候要重点检查组件版本兼容性。

二、升级兼容的组件版本（最推荐的方案） #

Selenium 3.11和Firefox 59的组合确实存在一些已知的兼容性bug，其中就包括窗口句柄传递的问题：

• 把Selenium升级到3.x分支的最新稳定版（比如3.141.59），这个版本修复了很多RemoteWebDriver的通信异常。
• 同步升级Firefox到对应兼容的版本（比如Firefox 60+），同时确保GeckoDriver版本和Firefox匹配：Firefox 59对应的GeckoDriver建议用v0.21.0，如果升级Firefox到60+，则需要对应升级GeckoDriver到v0.23.0及以上。

三、临时变通方案（如果无法立即升级） #

如果暂时不能升级组件，可以试试这些替代方法：

• 通过窗口标题/URL定位切换：遍历所有获取到的句柄，切换后检查窗口的标题或URL是否符合目标，绕过直接传递句柄的问题：

  String originalHandle = driver.getWindowHandle();
  Set<String> handles = driver.getWindowHandles();
  for (String handle : handles) {
      if (!handle.equals(originalHandle)) {
          driver.switchTo().window(handle);
          if (driver.getTitle().contains("目标窗口标题")) {
              break;
          } else {
              // 切换回原窗口继续遍历
              driver.switchTo().window(originalHandle);
          }
      }
  }
  

• 显式设置Marionette参数：在初始化RemoteWebDriver的DesiredCapabilities时，强制开启Marionette模式，确保Firefox节点用正确的驱动协议通信：

  DesiredCapabilities caps = DesiredCapabilities.firefox();
  caps.setCapability("marionette", true);
  RemoteWebDriver driver = new RemoteWebDriver(new URL("http://remote-node:4444/wd/hub"), caps);
  

四、检查RemoteWebDriver节点的运行环境 #

• 如果是Linux环境下的远程节点，确保Firefox是在桌面环境下运行（比如用Xvfb虚拟桌面），无桌面环境可能导致窗口句柄无法正常生成。
• 检查节点的Firefox配置，有没有禁用JavaScript或窗口相关的特性，这些设置可能影响句柄的传递。

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