执行flutter run命令无法在iOS模拟器构建运行Flutter应用

问题场景 #

执行flutter run命令在iOS模拟器上构建、运行任意Flutter应用时均无法正常启动，错误信息参考截图：

排查解决步骤 #

按顺序执行以下操作，每步完成后可尝试重新运行flutter run验证问题是否修复：

• 清理全链路构建缓存
  先退出所有Xcode、iOS模拟器进程，在项目根目录依次执行以下命令：

  flutter clean
  flutter pub get
  cd ios
  pod deintegrate
  pod install --repo-update
  cd ..
  

• 校验Xcode环境配置
  1. 终端执行flutter doctor，查看iOS工具链是否存在红色报错项
  2. 打开Xcode，进入「Settings > Locations」，确认Command Line Tools项已选中当前安装的Xcode版本，不可留空
  3. 终端依次执行以下命令，完成Xcode许可确认和初始化：

     sudo xcodebuild -license accept
     sudo xcodebuild -runFirstLaunch
     

• 重置iOS模拟器状态
  模拟器缓存残留是这类通用构建错误的高频诱因，可执行以下命令批量关闭并重置所有模拟器：

  xcrun simctl shutdown all
  xcrun simctl erase all
  

  也可以打开模拟器后，通过顶部菜单栏「Device > Erase All Content and Settings」手动重置当前模拟器。
• 校验构建架构配置
  1. 进入项目iOS目录，打开Runner.xcworkspace（注意不要打开后缀为.xcodeproj的文件）
  2. 选中Runner Target，进入Build Settings标签页，找到Excluded Architectures配置项，确认模拟器Debug/Profile/Release配置下没有错误排除arm64架构：M系列芯片Mac的iOS模拟器需要arm64架构支持，Intel芯片Mac需要x86_64架构支持
  3. 若为M系列芯片设备，可打开iOS目录下的Podfile文件，在顶部确认已指定最低iOS版本，例如platform :ios, '12.0'（版本号可根据项目实际需求调整），保存后重新执行pod install
• 修复版本兼容问题
  若以上操作均无效，大概率是Flutter版本与Xcode版本不兼容导致：
  1. 执行flutter channel stable切换到稳定发布渠道，再执行flutter upgrade更新到最新稳定版
  2. 若为刚升级Xcode后出现的问题，可执行rm -rf ~/flutter/bin/cache/artifacts/engine/ios*删除旧的iOS构建工具链缓存，再执行flutter doctor自动下载匹配的依赖文件

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