Appium uiautomator2驱动安装成功后未被服务器识别的问题排查

核心原因 #

Appium 2.x版本采用了独立的驱动管理机制，不能直接用npm命令安装驱动，必须使用Appium官方提供的appium driver系列命令，否则驱动不会被Appium识别。

具体修复步骤 #

1. 先卸载之前通过npm安装的驱动：

   npm uninstall -g appium-uiautomator2-driver
   

   （如果是本地项目内安装的，去掉-g参数）

2. 使用Appium官方命令安装uiautomator2驱动：

   appium driver install uiautomator2
   

3. 再次检查驱动状态：

   appium driver list
   

   此时应该能看到uiautomator2显示为[installed]。

额外排查点 #

• 确认当前使用的Appium版本是2.5.2：执行appium -v验证版本号，避免环境中存在多个Appium版本导致命令不匹配。
• 如果还是无法识别，检查Appium驱动默认安装目录（Windows下为%USERPROFILE%\.appium\node_modules），确认是否存在appium-uiautomator2-driver文件夹。
• 清理npm缓存后重试：

  npm cache clean --force
  

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