You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

WinAppDriver无法连接Windows应用,请求技术排查帮助

问题解决:WinAppDriver连接404错误及Appium客户端适配方案

核心问题分析

你的错误源于两个关键问题:

  • WinAppDriver的连接端点路径缺失,导致404 Not Found
  • Appium客户端默认生成的Capabilities格式带有appium:前缀,不符合WinAppDriver的要求

分步解决方案

1. 修正WebDriver连接端点

WinAppDriver的标准端点是http://127.0.0.1:4723/wd/hub,你当前使用的http://127.0.0.1:4723/缺少了/wd/hub后缀,这是触发404的直接原因。

2. 调整Desired Capabilities格式

WinAppDriver不识别Appium的命名空间前缀(如appium:),需使用原生键名。同时指定Chrome的方式推荐两种:

方式一:使用应用User Model ID(更可靠)

Chrome的User Model ID为Google.Chrome_8wekyb3d8bbwe!Chrome,无需担心路径空格或版本变更问题:

desired_caps = {
    "app": "Google.Chrome_8wekyb3d8bbwe!Chrome",
    "platformName": "Windows",
    "deviceName": "WindowsPC"
}

方式二:使用完整应用路径(注意转义)

如果用路径,需正确处理空格和转义,推荐使用原始字符串:

desired_caps = {
    "app": r"C:\Program Files\Google\Chrome\Application\chrome.exe",
    "platformName": "Windows",
    "deviceName": "WindowsPC"
}

3. 确保WinAppDriver正确启动

  • 必须以管理员身份启动:普通权限可能无法获取应用控制权限,导致启动失败。
  • 避免用os.startfile启动:该方法不会等待服务完全就绪就执行后续代码,可改用subprocess模块并添加等待时间,或手动启动WinAppDriver后再运行脚本:
import subprocess
import time

# 以管理员身份启动WinAppDriver(Windows需通过PowerShell提权)
subprocess.run(["powershell", "-Command", "Start-Process", "WinAppDriver.exe", "-Verb", "RunAs"])
time.sleep(2)  # 等待服务初始化完成

4. 验证WinAppDriver服务状态

启动WinAppDriver后,在浏览器中访问http://127.0.0.1:4723/wd/hub/status,若返回如下格式的JSON,说明服务正常:

{"value":{"build":{"version":"WinAppDriver v1.2.1"},"os":{"name":"Windows 10","version":"10.0.19045"}}}

完整修正代码

import unittest
from appium import webdriver
import subprocess
import time

# 手动启动WinAppDriver后可注释以下两行
subprocess.run(["powershell", "-Command", "Start-Process", "WinAppDriver.exe", "-Verb", "RunAs"])
time.sleep(2)

desired_caps = {
    "app": "Google.Chrome_8wekyb3d8bbwe!Chrome",
    "platformName": "Windows",
    "deviceName": "WindowsPC"
}

# 使用正确的WinAppDriver端点
driver = webdriver.Remote("http://127.0.0.1:4723/wd/hub", desired_caps)

# 后续操作示例
driver.quit()

内容的提问来源于stack exchange,提问作者Felipe Platzer

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.22 09:15:32