对照最后一次成功和第一次失败的运行
比较提交、工作流、runs-on 标签和任务初始化日志里的镜像版本。标签相同也可能拿到更新后的镜像。再核对实际使用的 workspace、scheme、configuration 和 destination,确保本机复现的是 CI 执行的同一条命令。
在失败命令之前记录环境
在本机和 CI 都运行 sw_vers、uname -m、xcode-select -p、xcodebuild -version、xcodebuild -showsdks 和 xcrun simctl list devices available。如果构建步骤设置了 DEVELOPER_DIR,诊断步骤也要用相同的设置。
按第一条报错选择检查方向
如果 Swift 编译器不支持某个语言特性,先比较 Xcode 版本。镜像已安装所需版本时,可以在构建步骤把 DEVELOPER_DIR 指向实际的 Contents/Developer 路径,再运行 xcodebuild -version 确认。如果所需版本没有安装,选择提供该版本的镜像,或统一团队使用的版本。
如果找不到模拟器,用 simctl 查看已安装设备,再用 xcodebuild -showdestinations -scheme YourScheme 查看项目可用目标。实际构建用了 workspace 或 project 参数时,诊断也要带上同一参数。不要把本机的模拟器 UUID 写进托管工作流。
如果找不到 scheme,用全新检出的代码运行 xcodebuild -list,核对 scheme 是否共享并已提交。如果只有归档失败,检查第一条签名错误、归档配置和预置描述文件。诊断日志里不要输出签名凭据。
如果工具链一致,用全新检出的代码在本机运行 CI 的原命令。核对工作目录、生成文件和依赖安装,必要时做一次无缓存对照。最后用原提交只改一个变量重跑,并确认原先失败的步骤确实执行成功。
参考资料
https://github.com/actions/runner-images
https://docs.github.com/en/actions/how-tos/write-workflows/choose-where-workflows-run/choose-the-runner-for-a-job