升级Xcode 13后Flutter iOS构建失败 报xcodebuild多匹配目的地等错误

错误核心说明 #

本次构建失败的根因是Xcode 13升级后，Flutter iOS项目的头文件搜索路径配置异常，导致path_provider等原生插件无法找到Flutter核心头文件Flutter/Flutter.h。

修复步骤 #

• 第一步：清理本地缓存与旧构建产物
  在项目根目录依次执行以下命令：

  flutter clean
  rm -rf ios/Pods ios/Podfile.lock ios/Runner.xcworkspace
  flutter pub get
  

• 第二步：重新生成iOS Pod依赖配置
  进入项目ios目录后执行以下命令：

  cd ios
  pod deintegrate
  pod install
  

• 第三步：校验Xcode项目配置
  1. 打开ios/Runner.xcworkspace文件（禁止直接打开Runner.xcodeproj文件，会丢失Pod依赖配置）
  2. 选中左侧导航栏的Runner项目，进入「Build Settings」页面
  3. 搜索Header Search Paths配置项，确认列表中存在${inherited}配置，且排序优先级在最顶部
  4. 搜索iOS Deployment Target，将版本修改为12.0及以上，确保适配所有依赖插件的最低系统要求
• 第四步：适配兼容问题
  如果上述步骤执行后仍报错，按以下规则排查：
  • 当前使用的Flutter版本低于2.5稳定版的，升级到Flutter 2.5及以上稳定版本，旧版Flutter未完成Xcode 13的适配
  • 将pubspec.yaml中的path_provider依赖升级到最新2.x稳定版本，旧版path_provider存在Xcode 13兼容问题
  • 先在Xcode中点击构建按钮确认Xcode侧可正常构建，再执行flutter run启动应用

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