M1 Mac Appium iOS手动启正常,AppiumDriverLocalService启动报WDA架构错误
M1 Mac环境下Appium程序化启动WDA架构不匹配问题定位与解决
核心根因
- 环境变量PATH优先级配置错位:Java代码里手动给Appium进程设置的PATH把
/usr/local/bin放在了路径最前端,这个路径在Apple Silicon芯片的Mac上默认存放的是x86_64架构经Rosetta转译安装的工具链;而编译WDA需要的arm64原生工具链(包含Homebrew、xcodebuild等核心可执行文件)默认存放在/opt/homebrew/bin路径下。
当Appium被Java代码拉起来时,会按照PATH的优先级顺序查找可执行文件,优先调用/usr/local/bin下的x86版本xcodebuild编译WDA,最终生成的WDA测试包是x86_64架构的,和arm64架构的iOS模拟器不兼容,就会触发日志里的mach-o, but wrong architecture报错。 - 手动在终端启动Appium时,shell会自动加载用户配置文件(.zshrc/.bashrc)里预设的PATH顺序,把
/opt/homebrew/bin放在最高优先级,全程用原生arm64工具链编译WDA,所以不会出现架构不匹配的问题。 - 残留的错误架构WDA缓存:之前多次尝试启动生成的x86版本WDA包存在DerivedData目录下,后续启动时Appium会优先复用缓存的包,就算临时改对环境变量也可能复用旧的错误包。
- IDE运行模式干扰:如果承载Java测试代码的IDE是通过Rosetta转译以x86模式运行的,它拉起的所有子进程(包括Appium、xcodebuild)都会继承x86的运行上下文,就算PATH配置正确,编译出来的WDA依然是x86架构的。
分步解决操作
- 修正Java代码里的环境变量配置,调整PATH优先级,把M1原生arm64工具链路径放在最前端,补充编译WDA需要的基础环境变量,同时修正原代码里多余的斜杠路径问题:
HashMap<String, String> environment = new HashMap<>(); // 优先加载M1原生工具链路径,再拼接系统原有PATH,移除原配置里前置的x86路径 String correctedPath = "/opt/homebrew/bin:" + System.getenv("PATH"); environment.put("PATH", correctedPath); // 补充必要的基础环境变量,避免编译WDA时找不到用户目录、语言配置等资源 environment.put("HOME", System.getenv("HOME")); environment.put("LANG", System.getenv("LANG")); AppiumDriverLocalService server = AppiumDriverLocalService .buildService(new AppiumServiceBuilder() .withEnvironment(environment) // 修正原代码里多写的开头双斜杠,使用正确的原生路径指向node可执行文件 .usingDriverExecutable(new File("/opt/homebrew/Cellar/node/15.8.0/bin/node")) .withAppiumJS(new File("/Users/sagolGoru20/.npm-packages/lib/node_modules/appium/build/lib/main.js")) .usingAnyFreePort() .withArgument(GeneralServerFlag.SESSION_OVERRIDE) .withLogFile(new File("/Users/sagolGoru20/Programming/JavaProjects/MavenProjects/MobileAutomationProjects/firstAppiumProject/appiumLog.txt")) ); server.start();
- 清理旧的错误架构WDA缓存:打开之前错误日志里提到的DerivedData路径,把WebDriverAgent对应的整个文件夹全部删除,强制Appium下次启动时重新编译符合当前架构的WDA包。
- 校验工具链调用优先级:打开终端执行
which xcodebuild,确认返回的路径是系统原生路径(/usr/bin/xcodebuild)或者/opt/homebrew路径下的版本,而不是/usr/local/bin下的x86转译版本。如果发现调用了错误路径的x86版本,直接删除/usr/local/bin下对应的软链即可。 - 修正IDE的运行架构:找到承载Java测试代码的IDE应用图标,右键打开「显示简介」,取消勾选「使用Rosetta打开」选项,让IDE以原生arm64模式运行,避免子进程继承x86的运行上下文。
验证方式
完成以上操作后重新运行测试流程,查看Appium日志里WDA的编译参数,确认编译目标包含arm64架构,启动模拟器时不会再抛出架构不匹配的报错。
内容的提问来源于stack exchange,提问作者Sagol Goru
相关产品推荐
相关产品推荐

