Xcode运行GitHub拉取的Flutter项目报PhaseScriptExecution非零退出码错误
Flutter iOS 编译报错
Command PhaseScriptExecution failed with a nonzero exit code 排查思路 - 优先校验Flutter环境一致性
绝大多数此类报错是本地Flutter版本和项目适配版本不兼容导致的脚本执行失败。先执行flutter --version查看本地版本,再核对项目根目录下的pubspec.lock、README文档确认项目适配的Flutter版本,版本不一致的话用FVM切换到对应版本后再重试构建。 - 全量清理缓存后重新构建
按顺序执行以下命令清理冗余缓存:- 项目根目录执行
flutter clean - 删除
ios/Pods文件夹、ios/Podfile.lock文件、ios/Runner.xcworkspace文件 - 执行
flutter pub get重新拉取依赖 - 进入ios目录依次执行
pod deintegrate、pod install --repo-update - 打开Xcode后点击顶部菜单栏
Product -> Clean Build Folder,再尝试运行项目
- 项目根目录执行
- 核对签名与权限配置
打开Xcode的Signing & Capabilities页,确认Team、Bundle ID配置正确,如果你用的是免费开发者账号,确认没有配置账号不支持的能力(比如推送、iCloud、App Groups等),权限不匹配也会触发该类报错。 - 查看具体报错日志定位问题
点击Xcode左侧导航栏的报错日志图标,展开PhaseScriptExecution的完整执行日志,定位具体是哪一段脚本执行失败。常见的报错来源包括Flutter编译脚本、CocoaPods执行脚本、第三方依赖的自定义执行脚本,拿到具体错误关键词后再针对性排查效率更高。 - 适配M系列芯片架构兼容问题
如果你使用的是M系列芯片的Mac,可在Podfile末尾添加以下配置解决模拟器架构兼容问题:post_install do |installer|
installer.pods_project.targets.each do |target|
flutter_additional_ios_build_settings(target)
target.build_configurations.each do |config|
config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'
end
end
end - 校验CocoaPods与Ruby版本
执行pod --version查看本地CocoaPods版本,版本低于1.11.0的话执行sudo gem install cocoapods更新后再重新安装pod依赖,旧版本CocoaPods和新的Flutter项目兼容性较差,容易出现脚本执行失败问题。
内容的提问来源于stack exchange,提问作者Vikram Puri
相关产品推荐
相关产品推荐

