Appium Inspector报Request timeout、failed to create session报错求解
Appium 1.20.2连接Inspector报请求超时、会话创建失败排查方案

按以下优先级逐一排查即可解决问题:
- 核对服务端与Inspector的配置一致性
Appium 1.x版本默认远程基路径为/wd/hub,先确认你启动Appium服务时没有在高级设置里自定义Base Path、监听端口,Inspector里填写的远程路径、端口必须和服务端配置完全对齐,默认监听端口为4723。如果之前启动过多个Appium实例,先把后台残留的node、Appium进程全部结束,避免端口冲突导致请求无响应。 - 校验Desired Capabilities参数
会话创建失败绝大多数是参数不匹配导致的:- 安卓测试场景:先执行
adb devices确认测试设备/模拟器处于device正常连接状态,不存在offline、未授权的情况。Capabilities中必须准确填写:platformName: Android、appium:deviceName(直接填adb devices输出的设备序列号即可)、appium:platformVersion(和设备实际安卓版本号完全一致)、appium:appPackage(待测APP的包名)、appium:appActivity(待测APP的启动入口Activity),安卓12及以上版本建议补充appium:noReset: true、appium:automationName: UiAutomator2参数。 - iOS测试场景:确认
appium:udid和真机/模拟器的UDID完全匹配、appium:bundleId填写正确,WebDriverAgent已完成签名编译并成功安装到测试设备。
- 安卓测试场景:先执行
- 排查环境和网络拦截问题
执行appium-doctor命令扫描环境依赖,确保安卓/iOS对应的SDK路径、构建工具等必填项全部配置正确,无红色报错。同时关闭系统全局代理、VPN,这类工具经常拦截本地环回端口的请求,直接触发超时。 - 根因定位直接看服务端日志
Inspector前端的超时提示没有参考价值,直接看Appium启动后的控制台运行日志,拉到报错对应的时间点,日志会明确打印失败原因:比如是缺少aapt等依赖、设备未授权、还是包名/Activity填写错误,按日志提示修复即可。
内容的提问来源于stack exchange,提问作者yoppie97
相关产品推荐
相关产品推荐

