Flutter 3.24.4 iOS项目启动失败：缺失Flutter.framework库

问题核心 #

崩溃日志明确指向Library not loaded: @rpath/Flutter.framework/Flutter，说明Flutter核心框架未被正确打包到应用的Frameworks目录，叠加环境PATH冲突、Apple Silicon架构适配问题，导致应用启动失败停留在LaunchScreen。

修复步骤 #

1. 解决Flutter环境PATH冲突

flutter doctor提示系统PATH中的flutter/dart路径与当前SDK目录不一致，先修正环境变量：

• 打开终端配置文件（~/.zshrc或~/.bash_profile）
• 添加或替换PATH配置：

  export PATH="/Users/nick/development/flutter/bin:$PATH"
  

• 执行source ~/.zshrc（对应自己的配置文件）使修改生效
• 验证：执行which flutter和which dart，确认输出路径为/Users/nick/development/flutter/bin/flutter及对应dart路径

2. 彻底清理缓存并重建项目

项目缓存或Pod依赖损坏可能导致框架嵌入失败，执行以下命令清理：

flutter clean
rm -rf ios/Pods
rm ios/Podfile.lock
rm -rf ~/Library/Developer/Xcode/DerivedData

重新安装依赖并启动：

cd ios && pod install --repo-update
cd .. && flutter run --debug

3. 检查Xcode的Framework嵌入设置

确保Flutter.framework被正确嵌入：

• 打开项目ios/Runner.xcworkspace
• 选中Runner target → 切换到General标签 → 找到Frameworks, Libraries, and Embedded Content
• 确认Flutter.framework存在，且Embed选项设置为Embed & Sign
• 若不存在，点击+按钮，添加项目内的ios/Flutter/Flutter.framework

4. 适配Apple Silicon架构

针对Apple Silicon模拟器的架构问题调整Xcode设置：

• 选中Runner target → 切换到Build Settings标签
• 找到Architectures，设置为Standard Architectures (arm64, x86_64)
• 找到Excluded Architectures，在Debug模式下添加arm64（仅模拟器生效，真机无需设置）
• 确认Build Active Architecture Only设置为Yes（Debug模式）

5. 验证Podfile配置

确保Podfile正确引入Flutter依赖：

• 打开ios/Podfile，确认包含以下配置：

  flutter_application_path = '../'
  eval(File.read(File.join(flutter_application_path, '.ios', 'Flutter', 'podhelper.rb')), binding)
  

• 若缺失，添加后重新执行cd ios && pod install

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