Mac端执行appium driver install xcuitest命令安装失败求助

问题复现 #

执行appium driver install xcuitest或appium driver install uiautomator2时失败，报错返回npm执行代码1，错误码EACCES，提示npm缓存文件夹包含root权限文件。已尝试官方建议的sudo chown -R 501:20 "/Users/USERNAME/.npm"命令，且查看过GitHub Issue #18006，仍无法解决，当前无任何Appium驱动安装成功。

解决方案 #

以下是针对性的权限修复步骤：

1. 通用化权限重置命令
   替换手动输入用户名的方式，用系统变量自动匹配你的用户身份，执行：

   sudo chown -R $(id -u):$(id -g) "/Users/$(whoami)/.npm"
   

   该命令会将.npm目录及其子文件的权限完全转移到当前登录用户。

2. 清理缓存后重置权限
   如果第一步无效，先强制清理npm缓存再重置权限：

   sudo npm cache clean --force
   sudo chown -R $(id -u):$(id -g) "/Users/$(whoami)/.npm"
   

3. 检查全局npm包目录权限
   部分Appium驱动安装依赖全局npm包，先查看全局包路径：

   npm config get prefix
   

   根据返回路径执行对应权限修复：

   • 若路径为/usr/local：

     sudo chown -R $(id -u):$(id -g) $(npm config get prefix)/lib/node_modules
     

   • 若路径为用户自定义目录（如/Users/XXX/.npm-global）：

     chown -R $(id -u):$(id -g) "/Users/$(whoami)/.npm-global"
     

4. 重新安装驱动
   完成上述步骤后，以普通用户身份重新执行安装命令：

   appium driver install xcuitest
   appium driver install uiautomator2
   

注意事项 #

避免使用sudo执行npm或Appium相关命令，这会导致目录权限被强制设置为root，引发后续权限冲突。

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