Flutter iOS应用启动失败：No such module 'Flutter'及CocoaPods解析错误

1. 锁定gRPC-Core至稳定版本 #

gRPC-Core 1.67.0-pre1作为预发布版本，其podspec文件可能存在格式问题，导致CocoaPods解析失败。可通过以下方式强制指定稳定版本：

• 打开项目的ios/Podfile，在target 'Runner' do代码块内添加：

  pod 'gRPC-Core', '1.66.0' # 可替换为最新官方稳定版
  

• 若该依赖是Flutter间接引入的，可通过post_install钩子强制替换版本：

  post_install do |installer|
    installer.pods_project.targets.each do |target|
      if target.name == 'gRPC-Core'
        target.version = '1.66.0'
      end
    end
  end
  

2. 彻底清理CocoaPods缓存 #

之前的清理操作可能未清除本地缓存的异常podspec，执行以下命令：

# 清理所有pod缓存
pod cache clean --all
# 删除CocoaPods全局缓存目录
rm -rf ~/Library/Caches/CocoaPods
# 删除本地仓库索引（可选，用于强制重新拉取仓库数据）
rm -rf ~/.cocoapods/repos

3. 重新执行pod install #

进入iOS目录后按顺序执行：

cd ios
rm -rf Pods Podfile.lock
# 更新仓库索引后重新安装依赖
pod install --repo-update

4. 修复Flutter模块引用问题 #

pod install成功后，确保Flutter模块正确引入项目：

• 打开Xcode项目，选择Runner Target，进入Build Settings
• 找到Framework Search Paths，确认包含$(inherited)和${FLUTTER_FRAMEWORK_DIR}两个路径
• 执行flutter clean && flutter pub get，重新同步Flutter依赖

5. 临时切换Flutter渠道（可选） #

若当前Flutter版本与gRPC预发布版本存在兼容性问题，可尝试切换渠道：

# 切换到beta渠道
flutter channel beta
flutter upgrade
# 问题解决后可切回stable渠道
flutter channel stable
flutter upgrade

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