WinAppDriver切换窗口触发TopLevelWindow WebException问题求助

针对你遇到的[windowHandle] is not a top level window handle错误，以下是几个可落地的解决思路：

1. 从主应用Session中直接遍历并切换窗口 #

不要通过桌面Session获取窗口句柄，而是复用最初创建的目标应用WindowsDriver实例，遍历它的所有窗口句柄，通过窗口标题或属性匹配数据库升级窗口：

var mainSession = SeleniumUtilities.GetWindowsDriver();
// 显式等待窗口句柄列表更新
var wait = new WebDriverWait(mainSession, TimeSpan.FromSeconds(10));
wait.Until(d => d.WindowHandles.Count > 0);

foreach (var handle in mainSession.WindowHandles)
{
    mainSession.SwitchTo().Window(handle);
    // 通过窗口标题判断是否为目标窗口
    if (mainSession.Title.Contains("Database Upgrade"))
    {
        DebugOutput.Log($"已切换到数据库升级窗口，句柄：{handle}");
        break;
    }
}

这种方式更贴合WinAppDriver的设计逻辑，因为主Session与目标应用实例绑定，获取的句柄都是该应用下的合法顶级窗口。

2. 修正窗口句柄的转换与使用方式 #

你当前转换NativeWindowHandle为十六进制的方式可能存在格式问题，WinAppDriver要求的句柄通常需要带0x前缀，同时要确保获取的是顶级窗口的句柄，而非子控件：

var desktopSession = SeleniumUtilities.GetDesktopDriver();
// 更精准定位顶级窗口，比如结合标题过滤
var icWindows = desktopSession.FindElementsByClassName("#32770");
foreach (var window in icWindows)
{
    if (window.Text.Contains("Database Upgrade"))
    {
        var nativeHandle = window.GetAttribute("NativeWindowHandle");
        // 转换为带0x前缀的十六进制字符串
        var hexHandle = $"0x{(int.Parse(nativeHandle)).ToString("x")}";
        // 先尝试激活窗口
        ActivateWindow(int.Parse(nativeHandle));
        // 再切换窗口
        mainSession.SwitchTo().Window(hexHandle);
        break;
    }
}

// 新增P/Invoke方法激活窗口
[DllImport("user32.dll")]
[return: MarshalAs(UnmanagedType.Bool)]
private static extern bool SetForegroundWindow(IntPtr hWnd);

private void ActivateWindow(int windowHandle)
{
    IntPtr hWnd = new IntPtr(windowHandle);
    SetForegroundWindow(hWnd);
    Thread.Sleep(500); // 等待窗口激活稳定
}

通过Windows API先激活窗口，确保它处于顶级状态后再切换，能避免WinAppDriver误判窗口层级。

3. 优化等待逻辑，确保窗口状态稳定 #

关闭重复实例窗口后，不要用固定的Thread.Sleep，改用显式等待目标窗口的可交互状态：

// 关闭重复实例窗口后
WhenSteps.WhenIClickOnButton("OK");
// 等待数据库升级窗口出现并可交互
var wait = new WebDriverWait(mainSession, TimeSpan.FromSeconds(15));
wait.Until(d => 
    d.WindowHandles.Any(h => 
    {
        d.SwitchTo().Window(h);
        return d.Title.Contains("Database Upgrade") && d.FindElement(By.Name("Yes")).Displayed;
    })
);
// 找到后直接操作
mainSession.FindElement(By.Name("Yes")).Click();

显式等待能避免因窗口加载延迟导致的操作失败，同时直接在等待逻辑中完成窗口切换。

4. 检查WinAppDriver版本与配置 #

确保你使用的WinAppDriver是最新稳定版，同时在初始化Appium选项时，确认已开启允许附加到已运行应用的配置：

var appOptions = new AppiumOptions();
appOptions.AddAdditionalCapability("app", @"C:\Path\To\Your\App.exe");
appOptions.AddAdditionalCapability("deviceName", "WindowsPC");
// 允许附加到已运行的应用实例
appOptions.AddAdditionalCapability("appium:noReset", true);
appOptions.AddAdditionalCapability("appium:fullReset", false);

正确的配置能让WinAppDriver更好地识别和管理应用的多窗口实例。

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