截至 2026 年 11 月 1 日,一条仍待分诊的用户议题记录:同一 workflow run 的 job 分别拿到不同的 macOS 26 镜像版本。本周先从每个 job 的 Set up job 日志记录 Runner Image Version,再固定提交和任务输入复现;不要靠反复重跑碰运气。有了证据,再决定是否需要更可控的构建主机。(GitHub 开放议题 #15208)
谁该看:macOS CI 维护者,可据此取证并分流同一 workflow 的环境差异。
iOS/macOS 工程师,可先验证根因,再决定是否改代码。
构建平台负责人,可比较托管 Runner 与自管 macOS 主机的维护责任。
GitHub Actions macOS 26 Runner 镜像过旧:先核对日志,不先改代码
GitHub 已确认 macOS 26 Runner 正式可用,macos-26 标签对应 Apple Silicon(arm64),并另有面向 Intel 的标签。但正式可用不等于每个 job 都拿到完全相同的镜像版本。镜像发布记录与某个 job 的实际分配情况,是两类不同证据。(GitHub macOS 26 正式公告)
议题 #15208 于 2026 年 11 月 1 日创建,页面目前仍标注为待分诊。提交者报告同一 workflow run 中的 job 使用了不同版本,也列出了更旧镜像继续分配的案例。这是有具体日志依据的用户报告,不是 GitHub 已确认的普遍故障,也没有证明镜像差异就是构建失败的原因。
这里的 Runner Image Version 指日志中 Runner 镜像的版本标识,不等同于 workflow 写下的 macos-26 标签。标签说明请求哪类 Runner;要确认某次执行的实际环境,必须看该 job 自己的记录。
怎么查看每个 job 的实际 Runner Image Version?
打开对应 workflow run,逐个点进 job,再展开 Set up job。GitHub 文档说明,GitHub 托管 Runner 的这个步骤会记录镜像详情,并提供预装工具清单链接;你应抄下每个 job 的 Runner Image 与 Version,而不是只截图 workflow 文件里的 runs-on。日志可以查看、搜索或下载,便于团队留档与比较。(GitHub Actions 日志文档)
如果要用命令行复核,可按任务记录 gh run view --job JOB_ID --log 的完整输出,再筛选镜像字段。不要只保存失败 job:成功 job 也可能是定位差异的关键对照组。
同一 workflow 的 job 为什么会有不同结果?
先比环境,再比错误。相同的 runs-on 标签并不能代替实际镜像记录;同一轮运行中的不同 job 也可能因镜像版本、系统构建、工具链选择或任务配置不同而出现分歧。GitHub 的 macOS 26 正式公告确认了标签及架构;至于某次 job 的系统、Xcode 和预装工具版本,应以该 job 日志及对应镜像说明为准。
建议把成功和失败 job 放进同一张排查记录,按以下字段逐行比较:
- 提交与任务:commit SHA、workflow 文件版本、触发事件、矩阵参数、构建目标。
- Runner 环境:标签、
Runner Image Version、操作系统版本、uname -m返回的架构。 - Apple 工具链:
xcodebuild -version、xcode-select -p、Swift 版本,以及项目指定的 SDK 和部署目标。 - 依赖与缓存:锁文件、依赖解析结果、缓存是否命中、构建脚本是否拉取了浮动版本。
- 错误位置:失败发生在依赖安装、编译、链接、签名还是测试阶段;保留原始错误行和前后日志。
系统版本相同也不代表工具链完全相同。反过来,如果镜像版本不同,也不能据此直接认定它是根因。先看失败特征是否随版本分组出现,再通过可控复现排除缓存、任务输入和依赖浮动。
macOS 26 arm64 Runner 出错:把平台分配与项目故障分开验证
排查的目标不是证明“旧镜像有问题”,而是确认错误能否在固定条件下随环境变化复现。单个议题中提到的具体错误,只能说明该提交者遇到过该症状;不能直接推广为所有项目都会遇到的问题。议题页面还将是否属于回归标为未知,故障范围仍须由你的项目记录来判断。
按这套顺序做隔离复现:
- 保留原始证据。保存成功与失败 job 的运行记录、日志、commit SHA、镜像版本和开始时间。先别清缓存、升级依赖或同时改构建脚本,否则变量混在一起。
- 固定输入。选定同一提交、同一 workflow 文件和同一任务参数。明确记录 Xcode 选择方式、依赖锁文件及缓存策略。
- 核对机器状态。在日志中记录
sw_vers、uname -m、xcodebuild -version、xcode-select -p和相关工具版本,并与 Runner 镜像说明对照。 - 对照成功与失败。同一提交若有成功、失败 job,逐项比较镜像版本及工具链;同时确认矩阵参数、缓存命中和下载依赖是否一致。
- 减少变量再复跑。若结果仍不稳定,使用相同任务输入做受控复跑,并明确标记这是新一次 Runner 分配,不把重跑视为固定镜像测试。
- 判断关联,不越级下结论。若错误持续只出现在某一镜像版本,记录为“版本相关的复现证据”;要进一步归因,仍需对照镜像变更内容,并排除项目和依赖变化。
由此才能把 macOS CI 构建复现与碰巧重跑成功区分开。复跑可以帮助观察新一次执行,却不等于把原 job 固定到某个镜像。GitHub 文档说明重跑使用原 workflow 的 GITHUB_SHA 和 GITHUB_REF;它并未承诺重跑必然分配最新镜像。(重跑 workflow 文档)
镜像发布后,怎样确认新版进入了实际 job?
先查 runner-images 发布记录,核对对应 macOS 镜像的发布日期、版本和变更,再对照新 job 的 Set up job 日志。发布页记录的是发布信息;只有任务日志才能证明该次 job 实际使用了哪个版本。以核查时能看到的发布页为例,其中列出了版本 20261026.0455.2,并标记为 2026 年 10 月 28 日发布。不能只因为新版已发布,就推断所有执行都已切换。
还要区分镜像版本和操作系统版本:前者对应镜像构建发布,后者描述系统本身。官方 macOS 26 Runner 页面会公布系统、内核和镜像版本;这些信息能帮助你识别环境,却不能替代自己的 job 日志。
若新旧版本交替出现,按 job 记录分组留档,再比较错误是否随实际版本变化。临时处置以团队验证过的隔离、回退或重新验收为准。不要假定重复重跑一定命中新镜像,也不要假设你能自行排空托管镜像池。
用可勾选清单判断下一步,而非无限重跑
- [ ] 已分别保存成功与失败 job 的 Set up job 日志,并记录实际镜像版本。
- [ ] 已确认待比较的 job 使用同一提交、同一 workflow 和可比任务输入。
- [ ] 已记录系统版本、架构、Xcode、SDK 与依赖解析结果。
- [ ] 已检查缓存、矩阵参数和构建目标,避免把它们误当成镜像效应。
- [ ] 已对照官方发布记录与镜像说明,确认“新版已发布”及“新版已进入 job”是两个独立判断。
- [ ] 若要重复执行,已将其作为新样本记录,而不是当作固定版本验证。
- [ ] 若考虑迁移,已明确主机维护、凭据隔离、清理策略和 workflow 验收负责人。
判断方式:若失败与镜像版本没有稳定对应关系,继续查项目代码、依赖与缓存;若同提交、同输入下的错误持续与某个镜像版本相关,先隔离该路径并留存证据,再决定是否调整构建主机。迁移可以增加环境控制能力,但不能自动修复项目依赖或构建脚本。
托管 Runner 与受控 Mac:控制力不同,责任也不同
GitHub 文档列出标准 macOS Runner 的架构与规格,也说明了 macos-26 等标签;自管 Runner 则需要你配置标签并承担机器维护。选择时重点看环境变更是否可见、能否管理工具链、凭据和任务隔离由谁负责,而不是只比较“云端”与“自建”名称。自管 Runner 的安全边界尤其要纳入评估:GitHub 提醒,不可信 workflow 代码可能持续影响自管环境,因此应结合仓库权限和隔离设计审查。(Runner 选择文档)
下表是运维责任的定性评估,不是性能测试或故障率统计:
| 方案 | 工具链控制 | 环境变更可见性 | 维护与隔离责任 | 更适合的条件 |
|---|---|---|---|---|
| GitHub 托管 Runner | 中:workflow 可选择标签、配置工具,但镜像状态需按 job 日志核对 | 中:可保存日志并比对发布记录 | 低:基础 Runner 由平台维护,项目仍要管理依赖与构建过程 | 优先减少机器运维,且能接受托管镜像变化 |
| 自管 Runner | 高:由团队管理机器和镜像制作 | 高:可建立自身发布、验收记录 | 高:需要负责更新、清理、凭据、并发与不可信代码隔离 | 项目确实要求更细的环境管理,且团队能承担日常运维 |
| VPSPush 远程 Mac | 可在真实 Mac 上按项目要求配置;实际控制范围应以服务说明和验收为准 | 需由你记录工具链与构建结果 | 你仍需管理依赖、密钥和 workflow;主机可用不等于构建自动可复现 | 需要远程真实 macOS 环境,并愿意先用真实 workflow 验收 |
如需评估远程访问方式,可先看 远程桌面使用说明;若要确认账号与服务相关问题,可查阅 帮助中心。这两项信息不能代替项目验收:迁移前仍应确认 Xcode、依赖、签名和凭据流程能否按你的要求运行。
结论:先验证镜像关联,再选择是否迁移
托管 Runner 的短板在于:镜像由平台维护,实际 job 版本可能需要逐项核对;发布说明不能证明某次执行已经切换;重跑也不能保证进入指定的新镜像。另一方面,自管或远程 Mac 也不是零成本替代:你需要验收工具链、维护依赖,并承担权限与任务隔离责任。若当前构建不需要额外环境控制,保留托管 Runner 并做好日志取证通常更合适。
如果生产构建确实需要更可控的 macOS 环境,而且团队能承担验收与维护,再把 VPSPush 远程 Mac 纳入小范围测试。先按真实 workflow 核对工具链、重复构建结果、凭据权限和回退方式;不要把换主机当成修复托管镜像分配问题的保证。需要临时测试环境时,可先查看 VPSPush 方案说明,再决定是否租用。
最后更新于 2026 年 11 月 2 日。数据核实自 GitHub macOS 26 正式公告、runner-images 发布记录、Runner 选择与重跑文档、workflow 日志说明,以及开放议题 #15208;议题状态与发布信息均按核实当日页面记录,你的 job 环境应以对应运行日志为准。
需要稳定复现构建?把 Runner 放到你可控的 Mac 上
VPSPush 提供独享 Mac mini M4 物理机,可自行配置自托管 Runner、工具链与项目依赖,减少托管镜像变动带来的排查干扰。
