WinAppDriver无法通过相对XPath点击SQL Developer“新建连接”按钮的问题排查

我来帮你梳理下这个问题的常见原因和解决办法，结合你的代码来看，有几个关键坑需要注意：

1. 代码里的变量作用域硬伤 #

你在try块里重新定义了var windriver，而全局声明的windriver变量根本没被赋值！这会导致后面执行windriver.FindElementByXPath时直接抛出空引用异常，根本到不了定位控件那一步。

修复方法：把try块里的var去掉，直接给全局变量赋值：

try  
{
    // 去掉前面的var，让全局windriver变量被正确初始化
    windriver = new WindowsDriver<WindowsElement>(new Uri("http://127.0.0.1:4723"), op); 
    windriver.Manage().Timeouts().ImplicitWait = TimeSpan.FromSeconds(30); 
    windriver.SwitchTo().Window(windriver.WindowHandles[0]);
    windriver.Manage().Window.Maximize();
}

2. XPath定位的准确性问题 #

SQL Developer是Java Swing应用，WinAppDriver对Swing控件的属性识别可能和标准Windows控件有差异。你用的//Button[@Name='New Connection']不一定准确，可能存在以下情况：

• 控件类型不是Button，而是其他Swing对应的控件类型（比如Pane或者自定义控件）
• Name属性值和你看到的界面文本不一致（比如实际是中文“新建连接”，或者有额外空格）

解决办法：

• 用Windows SDK自带的Inspect.exe（路径一般是C:\Program Files (x86)\Windows Kits\10\bin\10.0.xxx.0\x64\inspect.exe）查看控件的真实属性，找到最稳定的定位标识（比如AutomationId、ClassName或者准确的Name值）
• 调整XPath，比如用更宽泛的匹配或者结合其他属性：

  // 示例：匹配所有Name为"New Connection"的控件，不管类型
  WindowsElement newcon = windriver.FindElementByXPath("//*[@Name='New Connection']");
  // 或者结合控件类型（如果Inspect里看到是Button的话）
  WindowsElement newcon = windriver.FindElementByXPath("//Button[@Name='New Connection' and @ControlType='Button']");
  

3. 控件未完全加载，等待策略不足 #

虽然你设置了隐式等待，但SQL Developer的主界面加载完成后，“新建连接”按钮可能还在异步初始化，隐式等待不一定能覆盖到这种场景。

解决办法：改用显式等待，等待控件可点击后再执行点击操作：

using OpenQA.Selenium.Support.UI;

// ... 其他代码 ...

var wait = new WebDriverWait(windriver, TimeSpan.FromSeconds(30));
// 等待元素可点击
var newcon = wait.Until(driver => 
{
    var element = driver.FindElementByXPath("//Button[@Name='New Connection']");
    return element != null && element.Enabled && element.Displayed;
});
newcon.Click();

4. 窗口切换错误 #

你直接切换到了第一个窗口句柄windriver.WindowHandles[0]，但SQL Developer启动后可能存在后台隐藏窗口（哪怕加了-NoSplash参数），导致当前切换的窗口不是主界面，自然找不到按钮。

解决办法：遍历所有窗口句柄，找到正确的主窗口再切换：

// 遍历所有窗口，打印标题确认
foreach (var handle in windriver.WindowHandles)
{
    var tempWindow = windriver.SwitchTo().Window(handle);
    Console.WriteLine($"窗口标题：{tempWindow.Title}");
    // 切换到标题包含SQL Developer的窗口
    if (tempWindow.Title.Contains("SQL Developer"))
    {
        windriver.SwitchTo().Window(handle);
        break;
    }
}
windriver.Manage().Window.Maximize();

额外提示：WinAppDriver对Swing应用的局限性 #

SQL Developer基于Java Swing开发，WinAppDriver对这类非原生Windows控件的支持有限，如果以上方法都无效，可以考虑结合你代码里导入的SikuliSharp做图像识别辅助点击，作为兜底方案。

备注：内容来源于stack exchange，提问作者Sharad