升级Flutter后iOS与Android应用无法构建的问题求助

数据老陈

2026-6-13

Flutter升级后iOS/Android构建失败的解决方案

Android：Kernel版本不匹配（Unexpected Kernel Format Version 106 (expected 122)）

该问题核心是本地缓存的Kernel快照与当前Flutter/Dart版本不兼容，按以下步骤彻底清理：

清理项目缓存：

flutter clean
rm -rf .dart_tool build # macOS/Linux；Windows用rmdir /s /q .dart_tool build

清理Flutter SDK缓存：

rm -rf <你的Flutter SDK路径>/bin/cache # macOS/Linux；Windows对应删除文件夹

检查Dart版本一致性：
运行flutter --version确认Dart版本为Flutter自带版本，若存在全局安装的Dart，暂时从系统PATH中移除其路径，避免版本干扰。
重新初始化项目：
```
flutter pub get
flutter run --debug
```

这类问题多由Pods缓存或依赖版本不兼容导致，按以下步骤排查：

彻底清理iOS依赖缓存：

cd ios
pod deintegrate
rm -rf Pods Podfile.lock

清理Xcode构建缓存：
打开Xcode，执行Cmd+Shift+K清理Build Folder，或通过菜单栏Product > Clean Build Folder操作。
重新安装Pods并查看详细日志：
```
pod install
cd ..
flutter run --debug -v
```
注意：-v参数会输出完整构建日志，日志末尾可定位具体错误原因（例如某依赖与Xcode 15.4不兼容）。
检查Firebase依赖版本：
确认pubspec.yaml中Firebase相关依赖（如firebase_core、firebase_messaging等）的版本与当前Flutter版本适配，可参考各依赖的pub.dev页面版本说明。

切换到Flutter稳定版并升级：
```
flutter channel stable
flutter upgrade
```
运行flutter doctor -v，确认Xcode命令行工具、Android SDK、CocoaPods等开发环境配置无异常。
检查Android项目配置：
确认android/build.gradle中的gradle版本、android/app/build.gradle中的compileSdkVersion、targetSdkVersion与当前Flutter版本要求一致（例如Flutter 3.19+推荐compileSdkVersion 34）。