React Native+AWS Amplify构建iOS遇CocoaPods权限错误求助

架构老林

2026-6-25

解决方案：Expo + iOS 构建时「You cannot run CocoaPods as root」错误修复

不要用sudo执行npx expo start:ios——CocoaPods明确禁止以root权限运行，这是报错的直接触发点。sudo会让整个Expo进程以root身份运行，后续调用pod install时必然触发权限校验错误。

第一步：停止使用sudo执行Expo命令
直接运行正常权限的启动命令：
```
npx expo start:ios
```
如果遇到「权限不足」报错，不要加sudo，而是修复相关目录的所有权：
```
sudo chown -R $(whoami) ~/.expo ~/.npm ~/.cache
```
这条命令将Expo、npm、缓存目录的权限转回当前用户，避免后续权限冲突。
第二步：修正Ruby环境变量配置
你当前的.zshrc硬编码了Ruby版本（3.0.0），容易出现版本不匹配问题，建议替换为通用适配配置：
1. 打开配置文件：
```
open ~/.zshrc
```
2. 删除原有三条配置，替换为：
```
# Homebrew Ruby 路径配置
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"
export PATH="$HOME/.gem/ruby/$(ruby -e 'puts RUBY_VERSION.match(/\d+\.\d+/)[0]')/bin:$PATH"
```
3. 让配置立即生效：
```
source ~/.zshrc
```
第三步：重新安装用户级CocoaPods
先卸载可能存在的root级CocoaPods：
```
sudo gem uninstall cocoapods
```
再以当前用户权限重新安装：
```
gem install cocoapods --user-install
```
验证安装结果：
```
pod --version
```
能正常输出版本号则说明路径配置生效。
第四步：清理缓存并重新构建
清理Expo和Pod残留缓存，避免旧配置干扰：
```
npx expo prebuild --clean
rm -rf ios/Pods ios/Podfile.lock
npx pod-install ios
```
完成后重新启动构建：
```
npx expo start:ios
```