症状:GitHub 当前限制表列出的标准托管 macOS 并发上限,按计划为 Free、Pro、Team 各 5 个,Enterprise 为 50 个;较大规格托管 Runner 也计入 macOS 并发上限。官方限制表
最快解法:先核对托管 Runner 并发用量、工作流 concurrency 和自托管 Runner 路由;只有真实记录显示关键任务持续受容量约束,才评估分流或增加 Mac 承载。
谁该看:企业 IT 负责人,用于判断排队是否威胁发布计划与采购决策。 CI 平台工程师,用于分辨平台并发限制、工作流串行和 Runner 路由故障。 技术负责人或 FinOps 负责人,用于按队列证据决定先优化、分流还是扩容。
最后更新于 2026 年 11 月 20 日;限制、作业查看、concurrency、Runner 路由及 macOS-26 镜像信息已按 GitHub 官方文档 和 Runner 镜像清单 核对。组织的实际并发用量和等待情况仍须从你自己的设置页与作业记录确认。
先定位 GitHub Actions macOS-26 队列排队发生在哪一层
“排队”不是一个足以直接指向 Mac 节点不足的诊断结果。先记录工作流触发时间、作业当前状态、Runner 类型、runs-on 配置,以及从进入等待到开始执行的实际区间;如果作业被取消或替换,也要记下来。这样才能分清触发、调度、Runner 接单和真正执行,不会把不同故障混成一种容量问题。
GitHub Actions macOS-26 Runner 一直排队时,先看什么?
打开仓库的 Actions 页面,进入对应工作流运行记录,查看作业状态及事件时间;随后把该记录与组织或企业设置中的 GitHub-hosted Runner 作业用量对照。GitHub 提供查看托管 Runner 活跃作业及排队作业用量的方法,可用来判断是否已触及当前并发额度。查看组织或企业的当前作业
同时记下作业最终路由到 GitHub-hosted 还是自托管 Runner,以及具体标签。macOS-26 镜像清单区分不同架构和 Runner 标签;不要只看到 macos-26 就假设它和 macos-26-intel 指向相同环境。GitHub Actions Runner 镜像与标签
**注意:**限制表是平台规则,不是你们组织的实时用量仪表盘。排队期间先查设置页的作业用量和对应作业记录;单次等待只能说明那次运行发生了等待,不能证明团队长期缺少节点。
区分并发上限、工作流串行与 Runner 路由
这三类问题表面上都可能让作业迟迟没有开始,但处置手段不同。用下表确定先查哪处,别在证据不明时直接走采购或扩容流程。
| 优先诊断 | 可观察到的线索 | 核验位置 | 初步评分 |
|---|---|---|---|
| GitHub-hosted 并发额度 | 多个托管作业同时活跃,新作业等待;用量接近设置页显示的额度 | 组织或企业的 Actions Runner 设置、作业记录 | 若用量与等待对应:容量证据高 |
工作流 concurrency | 同组运行出现等待、旧的待处理运行被替换,或运行行为符合配置的取消规则 | 工作流文件中的工作流级和作业级 concurrency | 若同组规则能解释状态:策略证据高 |
| 自托管 Runner 离线或路由不匹配 | 作业指向自托管,但没有可接单的在线空闲 Runner;标签或组与任务要求对不上 | Runner 状态、runs-on、Runner group、Runner 日志 | 若标签或在线状态不符:路由证据高 |
| 托管 macOS 启动等待 | 并发用量未显示触顶,但不同运行记录中仍有托管 macOS 启动等待 | 多次作业记录、Runner 类型、触发时间及平台状态 | 若只有孤立个例:证据偏低 |
是 GitHub Actions macOS Runner 并发限制,还是 Runner 不在线?
如果任务使用 GitHub-hosted Runner,先对照你当前计划的可用并发与活跃作业数。限制表列出的 macOS 并发适用于标准托管 Runner;其中标准与较大规格托管 macOS Runner 的上限共享,所以切换较大规格不应被默认视为取得额外 macOS 并发额度。
如果任务使用自托管 Runner,进入仓库、组织或企业的 Runner 设置,确认目标节点显示在线且空闲,并检查 runs-on 要求的标签与 Runner group。标签和组的匹配条件会共同决定任务路由;只要有一项不匹配,作业就可能找不到可接单的节点。自托管 Runner 的工作流路由规则
GitHub 文档说明,自托管 Runner 必须在线、运行 Runner 应用并能与 GitHub 通信;不符合路由条件时,作业可能继续留在队列。自托管 Runner 状态与路由说明 因此,如果设置页显示 Runner 离线,先看主机、Runner 服务和通信日志,而不是增加另一台规格相同的 Mac。
检查 concurrency 是否主动让作业等待或被替换
工作流级和作业级 concurrency 都可能改变你观察到的运行顺序。检查 group 的实际表达式,确认发布任务、分支和工作流是否意外落入同一个组;再检查 cancel-in-progress 和队列设置,判断旧运行是否会被取消,或新运行是否只能等待。
GitHub 的默认行为是在同一并发组只保留一个待处理运行;新运行到来时,原有待处理运行可能被替换。设置 queue: max 可以允许更多待处理运行,但也有队列上限,且不能与 cancel-in-progress: true 一起使用。工作流与作业并发控制说明
处理时区分两种任务:可丢弃的旧提交检查,可以评估取消过时运行;签名、发布或必须逐次保留的流水线,则要确认取消规则不会误删待交付任务。要拆分并发组,先验证新组名不会让原本需要互斥的发布任务并行执行。
核实托管 macOS 启动等待是否具有持续性
GitHub 官方说明,高需求时段 macOS 作业可能需要更长时间启动。这是平台侧可能发生的启动等待,不等于你所在组织必然缺少容量,也不能凭单次延迟认定平台故障。限制文档中的 macOS 高需求说明
按日期、工作流、Runner 类型和触发时段整理实际记录,比较等待发生时的并发用量、工作流组和 Runner 路由。若相同关键任务在不同运行中反复受影响,且并发和路由检查都不能解释等待,再把它列为容量评估依据。若仅有一次异常,先保留记录并复查后续运行,别急着采购节点。
需要区分“作业已进入运行状态,但步骤迟迟不推进”和“Runner 尚未接单”:前者检查步骤日志和 Runner 诊断日志,后者检查队列、并发和路由。启用诊断日志可获取 Runner 与 Worker 相关信息,帮助追踪 Runner 如何协调和执行作业。GitHub Actions 调试日志说明
按证据决定调整策略、任务分流或扩容
企业 iOS CI 扩容不应从“队列里看到了等待”直接跳到“加 Mac”。先把等待记录与发布影响、并发占用、自托管故障放在一起判断,再选择改工作流、修路由、转移部分任务,或增加 Mac 承载。
决策条件列表:
- 若托管并发用量触顶,且等待影响发布或关键测试,则先核实计划额度和活跃作业组成,再评估并发调整、支持渠道或把适合的任务分流;否则不要仅凭计划名称推断你能使用的实时额度。
- 若同一
concurrency组的等待或替换符合工作流规则,则按任务是否可丢弃来调整排队或取消策略;否则回到并发用量和 Runner 路由继续诊断。 - 若自托管 Runner 离线、空闲状态不符,或标签与 Runner group 无法匹配,则先恢复节点或修正路由;否则再判断节点供给是否不足。
- 若关键 macOS 任务在多次真实运行中持续等待,且前述规则和路由不能解释,则试点分流或额外 Mac 承载;否则保留当前配置,并继续用后续队列记录验证。
**经验提醒:**发布签名和正式交付链路要单独验收,不能因为普通编译任务能分流,就默认密钥访问、人工审批和产物留存也已满足团队要求。
用真实队列记录做扩容试点验收
按以下步骤操作,先形成可复核的诊断记录,再投入新资源:
- 选定观察范围。从团队真实运行中选取能够覆盖常规开发和发布高峰的记录,保存工作流、分支、触发时间、作业状态、Runner 类型及
runs-on配置。不要预设全团队都需要 macOS 节点。 - 复核托管并发。查看组织或企业的 GitHub-hosted Runner 作业用量,与目标作业排队记录逐项对齐;若用量未触顶,继续查
concurrency和平台启动等待,不要把问题直接归为额度不足。 - 审阅并发规则。搜索工作流与作业级
concurrency,记录组名表达式、取消策略和排队设置;通过代表性提交确认旧检查能否取消,发布运行是否必须保留。 - 核验自托管节点。在 Runner 设置中检查在线、空闲状态,再对照标签、Runner group 和
runs-on;若仍无法接单,查看 Runner 应用和通信诊断日志。 - 划分可分流任务。挑选边界清晰的 macOS 构建、测试或打包作业试点;先规定证书与密钥访问、缓存和产物流向、失败重试及回退路径,不要未经验证就把发布签名任务一起迁移。
- 比较试点记录。用相同工作流和可比较的运行条件,对照等待区间、构建结果、测试通过情况、签名和产物交付;如果试点改变了任务、配置或环境,标注差异,不要把结果直接归因于新增节点。
- 作出采购判断。只有在等待反复影响关键交付,且并发策略、路由修复和任务分流仍不足以解决时,才按实际占用与发布要求规划扩容;记录显示主要问题可由策略或故障修复解决时,先不增加固定承载。