Android端Appium会话创建失败 Appium Inspector连接模拟器报错

按以下顺序逐一排查，绝大多数同类问题都能定位解决：

1. 先确认服务与端口状态 #

• 执行端口占用检查：Windows系统跑netstat -ano | findstr 4723，Mac/Linux系统跑lsof -i:4723，确认4723端口没有被其他进程占用。如果有占用要么杀掉占用进程，要么换个空闲端口启动Appium服务。
• 不要一开始就给Appium加一堆自定义启动参数，先跑最干净的默认配置：命令行直接执行appium启动服务，看输出日志里有没有出现Appium REST http interface listener started on 0.0.0.0:4723的提示，确认服务真的正常启动了再连Inspector。

2. 核对Android基础环境 #

• 先执行adb devices命令，确认输出的设备列表里能看到你正在运行的安卓模拟器，且设备状态必须是device。如果状态是offline，依次执行adb kill-server、adb start-server重启adb服务，再重新检查设备状态，直到显示正常再往下走。
• 核对本地SDK路径配置：确认你配置的ANDROID_HOME/ANDROID_SDK_ROOT环境变量指向真实的安卓SDK目录，目录下必须完整安装platform-tools、build-tools、emulator三个组件，路径不要包含中文、特殊字符或者带权限限制的系统目录。
• 如果你用的是Appium 2.x及以上版本，必须安装UiAutomator2驱动：执行appium driver list查看驱动列表，要是uiautomator2没显示已安装，就跑appium driver install uiautomator2完成安装，装完重启Appium服务。

3. 修正Appium Inspector会话参数 #

会话参数填错是最高发的失败原因，必填参数不能缺、不能拼错，可参考下方最小可用配置：

{
  "platformName": "Android",
  "appium:platformVersion": "替换为你模拟器的实际安卓版本号，例如13、14",
  "appium:deviceName": "替换为adb devices输出里的模拟器设备名",
  "appium:automationName": "UiAutomator2",
  "appium:noReset": true
}

• 如果需要指定启动特定App，额外加的appium:appPackage、appium:appActivity参数值必须和模拟器内安装的App包名、启动Activity完全一致，拼写错误、包名不匹配都会直接触发会话创建失败。

4. 特殊场景坑点排查 #

• Windows系统不要把Appium、安卓SDK装在C盘需要管理员权限的Program Files目录下，启动Appium时可以右键选择「以管理员身份运行」排除权限问题。
• 打开安卓模拟器的开发者选项，确认「USB调试」开关已打开，安卓12及以上版本的模拟器还要额外打开「USB调试（安全设置）」选项，允许调试操作修改系统权限。
• 如果之前装过旧版本Appium，先把旧版本完全卸载，同时删除用户目录下的.appium缓存文件夹，重新安装最新稳定版，避免不同版本驱动、依赖混装导致的冲突。

错误信息参考截图：

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