Flutter构建iOS应用失败：Xcode返回状态码1，求助问题原因

问题描述 #

调试模式下启动lib/main.dart到iPhone 14 Pro模拟器时，Xcode构建完成后提示无法构建iOS应用，报错：

Uncategorized (Xcode): Exited with status code 1

无法在模拟器上启动应用，相关构建日志：

Launching lib/main.dart on iPhone 14 Pro in debug mode...
Running Xcode build...
Xcode build done.                                            6.6s
Failed to build iOS app
Uncategorized (Xcode): Exited with status code 1

Could not build the application for the simulator.
Error launching application on iPhone 14 Pro.

环境信息 #

• Flutter版本：Channel stable, 3.7.12
• macOS版本：13.4 22F5037d darwin-x64
• Xcode版本：14.3
• Android SDK版本：31.0.0-rc1
• Android Studio版本：2022.2

flutter doctor输出：

$flutter doctor:
[✓] Flutter (Channel stable, 3.7.12, on macOS 13.4 22F5037d darwin-x64, locale zh-Hans-CN) 
[✓] Android toolchain - develop for Android devices (Android SDK version 31.0.0-rc1) 
[✓] Xcode - develop for iOS and macOS (Xcode 14.3) 
[✓] Chrome - develop for the web 
[✓] Android Studio (version 2022.2) 
[✓] Connected device (4 available) [✓] HTTP Host Availability

解决方案 #

1. 清理构建缓存 #

• 执行Flutter清理命令：

  flutter clean
  

• 进入iOS目录清理Pod缓存并重新安装：

  cd ios
  rm -rf Pods Podfile.lock
  pod deintegrate
  pod install
  cd ..
  

• 打开Xcode，用快捷键Cmd+Shift+K清理Xcode构建文件夹，重启Xcode

2. 重置模拟器 #

• 关闭当前iPhone 14 Pro模拟器，打开模拟器菜单Hardware > Erase All Content and Settings重置模拟器
• 重启模拟器后重新尝试构建

3. 验证Xcode命令行工具 #

• 打开Xcode，进入Xcode > Settings > Locations，确认Command Line Tools选择的是Xcode 14.3
• 终端执行命令验证路径：

  xcode-select -p
  

  确保输出指向Xcode 14.3的安装目录

4. 升级Flutter版本 #

Flutter 3.7.12与Xcode 14.3理论兼容，但可尝试升级到最新稳定版：

flutter upgrade

5. 查看详细Xcode错误日志 #

直接通过Xcode打开项目的ios/Runner.xcworkspace，点击构建按钮，查看左侧Report Navigator中的详细日志——这个模糊报错背后通常有具体原因，比如签名配置、依赖冲突、资源文件错误等

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