You need to enable JavaScript to run this app. Flutter iOS GitHub Actions打包Run Script构建失败排查
优惠活动
大模型
产品
解决方案
定价
更多

Flutter iOS GitHub Actions打包Run Script构建失败排查

问题现象
  • 本地 macOS Catalina 10.15.7 + Xcode 12.3 环境下,执行cd ./ios && bundle exec fastlane beta可正常完成Flutter iOS项目打包
  • GitHub Actions macos-latest 环境下执行相同命令构建失败,核心报错为:
    • 归档流程中断,失败节点为PhaseScriptExecution Run Script阶段,对应Flutter工程内置的Script-9740EEB61CF901F6004384FC.sh脚本,执行退出码65
    • 日志显示当前已正确选中/Applications/Xcode_12.3.app,Fastlane弹出的“Xcode版本错误”提示为通用兜底告警,并非本次问题的真实根因
  • 已完成的排查动作:对齐本地CocoaPods 1.10.0版本、手动调整Xcode构建参数、在Fastfile内通过xcversion和xcode_select强制指定Xcode路径,问题仍未解决。
核心问题根源

报错里提示的Xcode版本错误和本次构建没有关系,真正的问题出在Flutter注入到iOS工程的Run Script执行逻辑上:

  • 这个脚本的运行逻辑是从项目下的ios/Flutter/Generated.xcconfig读取FLUTTER_ROOT的绝对路径,定位Flutter SDK的位置来完成编译
  • 若本地开发时未把这个文件加入.gitignore,直接将其提交到Git仓库,文件内存储的是你本地电脑的Flutter SDK路径(如/Users/你的本地用户名/flutter)
  • GitHub Runner上的Flutter SDK是内置在工具缓存目录里的,路径和你本地的完全不匹配。哪怕CI流程中执行了flutter pub get,因为这个配置文件已经被Git追踪、存在于工作区中,Flutter默认不会强制覆盖它,最终Run Script阶段找不对SDK路径,执行失败抛出退出码65。
可落地修复方案
  • 修正Git追踪规则:在项目根目录的.gitignore中新增ios/Flutter/Generated.xcconfig条目,执行git rm --cached ios/Flutter/Generated.xcconfig命令移除该文件的Git追踪,避免本地绝对路径被提交到仓库
  • 补全CI环境的路径传递逻辑:在Deploy to TestFlight/PGY步骤中,执行fastlane命令前主动导出Flutter相关环境变量,确保xcodebuild执行Run Script阶段时可正确读取路径:
    - name: Deploy to TestFlight/PGY
      run: |
        # 主动导出Flutter路径到全局环境
        export PATH="$PATH:`which flutter | xargs dirname`"
        export FLUTTER_ROOT=$(dirname $(dirname `which flutter`))
        cd ./ios && bundle exec fastlane beta
    
  • 增加CI流程的缓存清理步骤:在安装工具环节补充flutter clean命令,删除工程下旧的Flutter缓存、Pods依赖、DerivedData临时文件,强制Flutter流程在CI环境重新生成匹配当前Runner路径的配置文件
  • 修正Fastfile的冗余配置:移除Fastlane脚本中重复的Xcode选择逻辑,仅保留xcode_select指定的绝对路径配置、删除冗余的xcversion调用,避免命令执行顺序冲突导致的路径识别异常
  • 补全脚本执行权限:在pod install完成后,给Flutter相关构建脚本添加可执行权限,避免CI环境的默认文件权限导致脚本执行失败,对应命令为:
    chmod +x ios/Flutter/flutter_application_versions
    chmod +x ios/Flutter/flutter_export_environment.sh
    

内容的提问来源于stack exchange,提问作者Dolphin

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.07 08:24:09