升级iOS 18.0后Appium Inspector加载异常及自动化报错求助

架构老林

2026-6-17

iOS 18.0 + Appium Inspector 加载卡住及 waitForQuiescenceIncludingAnimationsIdle 报错解决方案

问题背景

升级至iOS 18.0后，使用Appium Inspector检查元素时持续处于加载状态，同时抛出报错：

org.openqa.selenium.WebDriverException: An unknown server-side error occurred while processing the command. Original error: -[XCUIApplicationProcess waitForQuiescenceIncludingAnimationsIdle: unrecognized selector sent to instance 0x30024c280

涉及环境：

Xcode: 16.0 beta 5 (16A5221g)
Appium: 2.11.15
iOS设备: 18.0
Appium Inspector: 2024.9.1
Node.js: 20.17.0

社区情况确认

这个问题在Appium社区和Stack Exchange上已有不少用户反馈，核心原因是Xcode 16 beta版本对XCUI框架的API做了变更，当前稳定版的Appium XCUITest驱动尚未适配iOS 18的新接口，waitForQuiescenceIncludingAnimationsIdle: 方法就是其中一个被调整的API。

可行解决方案

升级XCUITest驱动至Beta版本：
Appium官方已在beta驱动中适配iOS 18/Xcode 16的API变更，执行命令更新：
```
appium driver update xcuitest --beta
```

禁用Quiescence等待检查：
在Appium的capabilities中添加"waitForQuiescence": false，绕过触发报错的方法：

{
  "platformName": "iOS",
  "appium:platformVersion": "18.0",
  "appium:deviceName": "你的设备名",
  "appium:app": "路径/你的APP.ipa",
  "appium:waitForQuiescence": false
}

更新Xcode至最新Beta版本：
Xcode 16 beta 5可能存在已知API问题，尝试升级到最新的Xcode 16 beta版本（如beta 6及以上），Apple会在后续beta中修复部分框架兼容性问题。
重置Appium环境：
卸载并重装Appium，确保依赖无冲突：
```
npm uninstall -g appium
npm install -g appium
```
同时重启Appium服务和Inspector，执行xcode-select -p验证Xcode路径是否指向Xcode 16 Beta。