Selenium 4下WinAppDriver启动应用报参数错误，切换版本正常求助

问题背景 #

使用Selenium 4.6.0 + Appium Java Client 8.2.1启动Windows应用时，触发如下错误：

{"status":100,"value":
 {"error":"invalid argument","message":"Bad capabilities. Specify either app or appTopLevelWindow to create a session"}}

但切换到Selenium 3.141.59版本时，应用可正常启动。

解决方案 #

1. 用WindowsOptions替代DesiredCapabilities #

Selenium 4.x推荐使用平台专属的Options类配置会话，Appium Java Client 8.x提供的WindowsOptions会自动适配W3C标准的Capabilities格式，避免参数传递失败。修改后的代码示例：

WindowsDriver adminApp = null;
WindowsOptions winOptions = new WindowsOptions();
winOptions.setCapability("app", "C:\\Program Files\\Traka\\Traka Web Admin\\TrakaWebAdmin.exe");
winOptions.setCapability("ms:experimental-webdriver", true);
winOptions.setPlatformName("Windows");
winOptions.setAutomationName("Windows");
adminApp = new WindowsDriver(new URL("http://127.0.0.1:4723/"), winOptions);

2. 调整依赖版本以匹配 #

Appium Java Client 8.2.1与Selenium 4.6.0存在兼容性偏差，建议升级Selenium到4.10.0及以上版本，确保依赖协同工作：

<dependency>
    <groupId>org.seleniumhq.selenium</groupId>
    <artifactId>selenium-java</artifactId>
    <version>4.10.0</version>
</dependency>
<dependency>
    <groupId>io.appium</groupId>
    <artifactId>java-client</artifactId>
    <version>8.2.1</version>
</dependency>

3. 更新WinAppDriver至最新稳定版 #

旧版本WinAppDriver对Selenium 4的W3C Capabilities支持不完善，安装最新稳定版的WinAppDriver，确保服务端能正确解析参数。

原因分析 #

Selenium 4.x全面切换到W3C标准的Capabilities协议，而DesiredCapabilities属于旧JSON Wire协议的实现，在与Appium Java Client 8.x配合时，会出现参数映射错误，导致WinAppDriver无法识别已配置的app参数，进而抛出“Bad capabilities”错误。使用WindowsOptions则会按照W3C规范构造请求，解决该兼容性问题。

内容的提问来源于stack exchange，提问作者D. Barnett