Xcode归档Flutter应用触发Dart snapshot generator exit code -5报错如何解决

按优先级从高到低执行以下操作即可覆盖绝大多数场景：

• 全量清理构建缓存，在项目根目录依次执行命令：

flutter clean
rm -rf ios/Pods ios/Podfile.lock build ~/Library/Developer/Xcode/DerivedData/*
flutter pub get
cd ios
pod deintegrate
pod install --repo-update

缓存残留是这个报错最高发的诱因，尤其是跨Flutter版本构建、切换过开发渠道之后，必须做全量清理。

• 检查Xcode架构配置：打开ios/Runner.xcworkspace，选中Runner target，进入Build Settings页，找到Excluded Architectures配置项，Release模式下仅保留对模拟器SDK的i386、x86_64架构排除，不要给真机SDK加任何排除项；同时确认Build Active Architecture Only在Release模式下设为No。
• 校验Flutter环境完整性：执行flutter channel stable切到稳定渠道，执行flutter upgrade对齐稳定版最新补丁，再跑flutter doctor -v确认没有未解决的环境报错；如果近期升级过Flutter/Dart版本，额外执行dart pub cache repair修复全局包缓存损坏问题，快照生成进程遇到损坏的包缓存就会返回-5退出码。
• 检查AOT编译兼容性：如果项目里用到了dart:mirrors库，或者引入了仅支持JIT运行的第三方包，会直接导致Release构建快照生成失败，可以先新建空白Flutter项目测试归档流程，如果空白项目构建正常，用二分法移除近期新增的依赖即可定位问题包。
• Pod配置相关排查点：只有当你手动修改过Podfile中flutter_additional_ios_build_settings逻辑、调整过Build Phases脚本顺序时才会触发这类问题，检查Build Phases下的脚本顺序，确保Flutter的Run Script脚本排在Embed Frameworks、[CP] Embed Pods Frameworks之前，不要给Flutter脚本加任何自定义的环境变量覆盖。

如果以上操作都无法解决问题，补充以下信息即可进一步定位：

1. flutter doctor -v的完整输出
2. ios目录下Podfile的完整内容
3. Xcode归档日志中PhaseScriptExecution条目展开后的完整报错明细

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