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
相关产品推荐
相关产品推荐

