Appium Inspector启动会话持续报invalid session id转NoSuchDriverError

问题概述 #

启动Appium Inspector会话时，持续触发invalid session id错误，随后转为NoSuchDriverError；命令行返回404错误，对应NoSuchDriverException堆栈信息。已尝试重置重启设备、卸载重装Appium Inspector，问题未彻底解决。

当前环境信息 #

• Appium服务启动命令：appium -p 4724 --allow-cors
• Capabilities配置：

{
  "platformName": "Android",
  "appium:platformVersion": "12",
  "appium:deviceName": "Pixel 7 API 31 (S)",
  "appium:app": "D:\\Automation_code\\TestAutomation\\test\\app\\Android_app_demo-244.apk",
  "appium:automationName": "UIAutomator2"
}

解决方案 #

1. 校验版本兼容性 #

• 确认Appium Server与Appium Inspector版本匹配：执行appium --version查看服务版本，对照Inspector关于页面的版本号，避免混用Appium 1.x与2.x组件。
• 若使用Appium 2.x，确保已安装UIAutomator2驱动：执行appium driver list检查，未安装则运行appium driver install uiautomator2。

2. 修正Capabilities配置 #

• 验证设备系统版本：通过adb shell getprop ro.build.version.release确认设备实际Android版本，确保与appium:platformVersion一致。
• 检查应用路径：确认appium:app指向的APK文件存在，Windows路径可尝试改用正斜杠/（如D:/Automation_code/...）。
• 可选添加重置参数：加入"appium:noReset": true避免每次启动重置应用，减少会话异常概率。

3. 调整服务启动参数 #

• 移除--allow-cors参数，改用默认命令启动：appium -p 4724，CORS配置可能干扰会话建立。
• 开启调试日志排查细节：执行appium -p 4724 --log-level debug，查看日志中是否存在驱动初始化失败、应用安装失败等关键错误。

4. 清理缓存与进程 #

• 终止所有Appium相关进程：Windows任务管理器结束node.exe进程后重启服务。
• 清理UIAutomator2缓存：执行以下命令后重启设备：

  adb shell pm clear io.appium.uiautomator2.server
  adb shell pm clear io.appium.uiautomator2.server.test
  

• 删除Appium临时文件：清空Windows路径%APPDATA%\Appium下的缓存文件，再重启服务。

5. 检查Inspector会话配置 #

• 确认Inspector的远程配置：
  • Remote Host：localhost
  • Remote Port：4724
  • Remote Path：Appium 1.x填/wd/hub，Appium 2.x填/，路径错误会直接导致404。

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