You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Xcode运行GitHub拉取的Flutter项目报PhaseScriptExecution非零退出码错误

Flutter iOS 编译报错 Command PhaseScriptExecution failed with a nonzero exit code 排查思路
  • 优先校验Flutter环境一致性
    绝大多数此类报错是本地Flutter版本和项目适配版本不兼容导致的脚本执行失败。先执行flutter --version查看本地版本,再核对项目根目录下的pubspec.lock、README文档确认项目适配的Flutter版本,版本不一致的话用FVM切换到对应版本后再重试构建。
  • 全量清理缓存后重新构建
    按顺序执行以下命令清理冗余缓存:
    1. 项目根目录执行flutter clean
    2. 删除ios/Pods文件夹、ios/Podfile.lock文件、ios/Runner.xcworkspace文件
    3. 执行flutter pub get重新拉取依赖
    4. 进入ios目录依次执行pod deintegrate、pod install --repo-update
    5. 打开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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.05 15:51:00