Flutter构建iOS失败：pod install出错及CocoaPods升级异常

一、修复Firebase/Firestore版本冲突 #

1. 清理旧依赖与缓存 #

• 进入项目iOS目录：cd ios
• 删除Podfile.lock文件：rm Podfile.lock
• 删除Pods文件夹：rm -rf Pods
• 返回项目根目录清理pub缓存并重新拉取依赖：

  flutter pub cache clean
  flutter pub get
  

2. 统一Firebase版本与部署目标 #

cloud_firestore 4.0.5要求Firebase SDK版本≥10.1.0，且最低iOS部署目标为12.0，需做以下调整：

1. 修改iOS目录下的Podfile，将platform :ios, '11.0'改为platform :ios, '12.0'，并添加全局Firebase版本锁定：

   platform :ios, '12.0'
   $FirebaseSDKVersion = '10.1.0' # 统一所有Firebase组件版本
   

2. 打开Xcode，选中项目根节点，在Build Settings中确认Deployment Target设置为iOS 12.0。

3. 重新执行Pod安装 #

在iOS目录下执行：

pod install --repo-update

若仍有冲突，可添加--verbose参数查看详细错误日志，确认是否有其他插件强制依赖旧版本Firebase，再针对性调整。

二、修复CocoaPods版本显示不一致问题 #

1. 排查版本冲突原因 #

执行which pod查看当前系统调用的pod路径，再执行pod --version确认实际版本。flutter doctor显示旧版本，说明系统PATH中旧版本的优先级更高。

2. 彻底清理重装CocoaPods #

• 卸载所有已安装的CocoaPods版本：

  sudo gem uninstall cocoapods -a
  # 若之前用brew安装过，同步卸载
  brew uninstall cocoapods
  

• M1芯片用户需通过Rosetta兼容模式安装指定版本：

  arch -x86_64 sudo gem install cocoapods -v 1.11.3
  

• 确认安装路径并调整系统PATH：
  执行gem which cocoapods得到路径（例如/Users/xxx/.rbenv/shims/cocoapods），将其所在的bin目录（如/Users/xxx/.rbenv/shims）添加到PATH最前端。修改~/.zshrc或~/.bash_profile文件：

  export PATH="/Users/xxx/.rbenv/shims:$PATH"
  

• 刷新配置并验证：

  source ~/.zshrc # 对应自己的shell配置文件
  pod --version
  flutter doctor
  

内容的提问来源于stack exchange，提问作者Ten Digit Grid