Flutter iOS构建失败：Framework not found Flutter问题求助

安全阿岳

2026-8-10

解决方案

重新生成Flutter iOS核心框架文件
执行以下命令强制重新生成iOS构建所需的Flutter框架资源：
```
flutter build ios --debug
flutter precache --ios
```
flutter precache --ios会提前下载iOS专属的Flutter依赖包，补全可能被误删的本地资源。
彻底重置CocoaPods依赖
进入项目的iOS目录后执行：
```
rm -rf Pods
rm -rf Podfile.lock
pod deintegrate
pod install --repo-update
```
这一步会完全清理旧的Pods依赖，重新拉取并集成最新的依赖包，避免残留的损坏配置影响构建。
检查Xcode项目路径配置
打开Xcode项目，进入Build Settings：
- 搜索Framework Search Paths，确认路径列表包含$(inherited)和${FLUTTER_FRAMEWORK_DIR}
- 搜索Other Linker Flags，确保包含$(inherited)和-framework Flutter
  这两个配置项负责让Xcode正确找到Flutter框架文件，若路径缺失会直接导致“Framework not found”错误。
修复Flutter本地环境（极端场景）
如果以上步骤都无效，执行Flutter环境修复命令：
```
flutter doctor --repair
```
该命令会自动检测并修复Flutter SDK中缺失或损坏的组件。若仍未解决，可尝试重新下载完整的Flutter SDK替换现有目录（注意备份项目的pubspec.yaml等配置文件）。