使用WinAppDriver连接已运行Windows应用时遇超时异常如何解决？

• 以管理员权限启动WinAppDriver
  WinAppDriver需要系统级权限才能遍历所有运行窗口，右键WinAppDriver.exe选择「以管理员身份运行」，或者在启动脚本中配置强制管理员权限，否则会因权限不足导致定位超时。

• 连接系统根节点而非特定应用
  要获取所有运行窗口，必须连接到Windows桌面根会话，而不是某个特定应用。示例代码：

  var options = new AppiumOptions();
  options.AddAdditionalCapability("app", "Root");
  options.AddAdditionalCapability("platformName", "Windows");
  var driver = new WindowsDriver<WindowsElement>(new Uri("http://127.0.0.1:4723"), options);
  

  连接Root节点后，才能访问系统所有顶层窗口对象。

• 延长等待超时时间
  Selenium默认隐式等待时间较短，显式调整超时参数：

  // 设置隐式等待
  driver.Manage().Timeouts().ImplicitWait = TimeSpan.FromSeconds(10);
  // 或者使用显式等待更可靠
  var wait = new WebDriverWait(driver, TimeSpan.FromSeconds(10));
  var windows = wait.Until(d => d.FindElementsByClassName("Window"));
  

• 匹配WinAppDriver与Windows系统版本
  WinAppDriver版本需对应Windows系统版本：比如Win10 21H2适配v1.2.1，Win11建议使用v1.2.99及以上版本。通过winver命令查看系统版本后，下载对应版本的WinAppDriver，避免版本不兼容导致API调用失败。

• 检查系统权限与安全软件拦截
  进入Windows设置「隐私和安全性-权限管理-窗口应用权限」，确保WinAppDriver具备窗口访问权限。同时关闭可能拦截窗口遍历的杀毒软件或隐私防护工具，部分安全软件会限制自动化工具的系统访问权限。

• 尝试替代定位方式
  如果ClassName("Window")仍超时，换用XPath或TagName定位：

  // XPath定位
  var windows = driver.FindElementsByXPath("//*[@ClassName='Window']");
  // TagName定位
  var windows = driver.FindElementsByTagName("Window");
  

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