iOS端Flutter项目构建失败，报FlutterDarwinContextMetalImpeller错误

问题详情 #

• 旧Flutter项目可正常运行，但新建项目完全无法工作，该问题覆盖模拟器、真机、TestFlight测试版本所有场景
• 构建时控制台报错：

[VERBOSE-2:FlutterDarwinContextMetalImpeller.mm(35)] Using the Impeller rendering backend.
Lost connection to device.
Exited

• Flutter Doctor检测结果全正常：

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.10.6, on macOS 13.1 22C65 darwin-arm64, locale en-TR)
[✓] Android toolchain - develop for Android devices (Android SDK version 33.0.0-rc2)
[✓] Xcode - develop for iOS and macOS (Xcode 14.3.1)
[✓] Chrome - develop for the web
[✓] Android Studio (version 2020.3)
[✓] VS Code (version 1.80.0)
[✓] Connected device (4 available)
[✓] Network resources

• 已尝试：重启设备、更新Flutter至最新稳定版、清理重建项目、创建多个新项目测试，均无效

解决方案尝试 #

1. 禁用Impeller渲染引擎 #

报错关联Impeller（Flutter 3.10+默认启用的渲染引擎），大概率是兼容性问题：

• 临时禁用（仅运行时生效）：
  在终端执行：

  flutter run --no-enable-impeller
  

• 永久禁用（适配TestFlight发布）：
  打开iOS项目的Info.plist文件，添加以下键值对：

  <key>FLTEnableImpeller</key>
  <false/>
  

2. 检查Xcode构建配置 #

打开iOS项目的Runner.xcworkspace，进入Runner target的Build Settings：

• 确认Architectures设置为Standard Architectures (arm64, x86_64)
• 确保Build Active Architecture Only在Debug模式下设为Yes，Release模式下设为No
• 清理Xcode构建缓存：菜单栏选择Product > Clean Build Folder后重新构建

3. 重置CocoaPods依赖 #

进入项目的ios目录，执行：

pod deintegrate
pod install

若遇CocoaPods版本问题，先更新：

sudo gem install cocoapods

4. 重置Flutter环境 #

执行以下命令清理缓存并修复依赖：

flutter clean
flutter pub get
flutter pub cache repair

5. 切换Flutter渠道测试 #

尝试切换至beta版验证，再切回稳定版：

flutter channel beta
flutter upgrade
flutter channel stable
flutter upgrade

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