升级Flutter 3.7.3后iOS归档失败：Flutter版本不匹配问题

问题现象 #

Flutter升级至稳定通道3.7.3版本，iOS模拟器运行项目正常，但归档时出现以下错误：

Failed to build iOS app
Error (Xcode): Expected Flutter 857bd6b74c5eb56151bfafe91e7fa6a82b6fee25, but found 248290d6d50a1bf1a6a246544347c03acda867a5

Encountered error while archiving for device.

Flutter doctor检测确认当前使用的是稳定版3.7.3。

解决方法 #

按顺序尝试以下步骤：

1. 清理缓存并重新依赖 #

• 执行Flutter清理命令：

  flutter clean
  

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

  cd ios
  pod deintegrate
  pod clean
  pod install
  cd ..
  

2. 重新生成iOS构建配置 #

• 执行命令触发Flutter重新生成iOS项目的构建配置：

  flutter pub get
  flutter build ios --release
  

完成后再尝试归档操作。

3. 检查Xcode中Flutter路径配置 #

• 打开Xcode，选中项目的Runner目标，进入Build Settings，搜索FLUTTER_ROOT和FLUTTER_FRAMEWORK_DIR
• 确认路径指向当前安装的Flutter 3.7.3版本（可通过which flutter命令获取当前Flutter安装路径），若路径错误则手动修改

4. 验证Flutter版本一致性 #

• 执行命令查看本地Flutter的commit哈希：

  flutter --version
  

输出中的commit哈希应与报错里"found"的哈希（248290d6d50a1bf1a6a246544347c03acda867a5）一致，这是3.7.3稳定版的正确commit。

• 若不一致，重新切换并更新稳定版：

  flutter channel stable
  flutter upgrade
  

5. 重启Xcode或电脑 #

部分缓存问题无法通过命令清理彻底解决，重启后再尝试归档。

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