Flutter iOS构建报错：module 'cloud_firestore' not found求助

以下是针对性的排查和修复步骤，按顺序尝试：

1. 彻底清理依赖缓存 #

• 执行Flutter清理命令：

  flutter clean
  

• 进入项目ios目录，手动删除Pods文件夹和Podfile.lock文件
• 重新拉取Flutter依赖：

  flutter pub get
  

• 回到ios目录更新并安装Pod：

  cd ios
  pod install --repo-update
  

  注：若项目使用use_frameworks!或use_modular_headers!，需确保Podfile配置与cloud_firestore的模块化要求匹配。

2. 修正Xcode项目配置 #

• 务必打开ios目录下的.xcworkspace文件（而非.xcodeproj）
• 在项目Build Settings中检查：
  • Enable Modules (C and Objective-C)设置为YES
  • Framework Search Paths包含$(inherited)和${PODS_ROOT}/cloud_firestore/ios
• 清理Xcode编译缓存：点击菜单栏Product -> Clean Build Folder，随后重启Xcode

3. 校验版本兼容性 #

• 确保pubspec.yaml中cloud_firestore的版本与Firebase iOS SDK版本兼容，可参考Firebase官方版本对照表
• 尝试升级至最新稳定版：

  cloud_firestore: ^latest_version
  

  替换latest_version为pub.dev上的最新稳定版本号，之后重新执行flutter pub get和pod install

4. 调整Podfile配置 #

• 确保Podfile顶部的iOS平台版本满足要求：

  platform :ios, '13.0'
  

  cloud_firestore目前要求iOS最低版本不低于13.0
• 若使用Flutter 3.10及以上版本，可尝试在Podfile中添加：

  use_frameworks! :linkage => :static
  

  静态链接框架可解决部分动态库加载异常问题

5. 重新生成插件注册文件 #

• 删除ios目录下的GeneratedPluginRegistrant.h和GeneratedPluginRegistrant.m文件
• 执行命令重新生成：

  flutter build ios --config-only
  

若以上步骤均无效，可新建一个空白Flutter项目仅添加cloud_firestore依赖，验证是否能正常构建，排查当前项目配置是否存在损坏。

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