掌握GitHub Actions 教学工作区 · 课程 0006 · 约 8 分钟 · 前置:0003 · Runner 与矩阵 · 2026-10-06
额度、计费与排障
你能做到:说清什么会让分钟数成倍消耗,并在流程变红时按固定顺序查到原因,而不是乱试。
1 | 账单按什么算
- ① 公开仓库的标准机器不计费。这也是「零服务器」这条路的起点:代码公开,跑检查不要钱(口径见官方计费页)。
- ② 私有仓库按分钟扣额度。额度用完之后可选「继续用、开始计费」或「直接停」,这是账户设置里的一档开关。
- ③ 不同系统有不同倍率。同一分钟的消耗,Linux、Windows、macOS 不是同一个价,倍率还会调整 ——
具体数字以官方计费页为准,不要背某个数当常量。
- ④ 产物与缓存占的是存储额度。它和分钟数是两笔账。
2 | 什么最费
| 写法 | 为什么费 | 怎么省 |
| 矩阵维度多 | 每个组合各开一台机器,作业数相乘 | 只在发布前跑全矩阵,日常只跑一个组合 |
| 每次推送都跑重活 | 同一个分支连推五次,就跑五遍 | 用 paths 过滤、用 concurrency 取消同分支的旧运行 |
| 不缓存依赖 | 每次都从零下载依赖 | 给包管理器接上缓存(见下) |
| 任务一直挂着等 | 等待与执行都算在这次运行里,长任务最贵 | 给命令加超时,别让它在网络请求上无限等待 |
| 用了 macOS 机型 | 它的倍率比 Linux 高 | 只在确实需要时用 |
3 | 红了怎么查:按顺序来
- ① 先问「它到底跑了没有」。事件对不对、分支和路径有没有把这次推送过滤掉、公开仓库的定时任务是不是已经因长期无活动被停用 —— 这一层没排除,后面全是白看。
- ② 再看是哪个作业的第几步。界面会把失败的步骤标出来;有多个作业时先看是不是某一个组合特有的问题(系统差别、版本差别)。
- ③ 读日志的尾巴。失败步骤的最后十几行就是答案:命令的退出码、最后一个报错、以及它前一条命令到底在干什么。
- ④ 按症状分类。403 / 没权限 → 权限那一段;找不到文件 → 路径或「上一步没成功」;连不上 / 超时 → 网络出口或对端不通;
排队很久 / 被取消 → 额度与并发。知道是哪一类,就不用瞎改 YAML。
- ⑤ 用重跑与调试开关。失败的作业可以只重跑它;在仓库的 secrets 里加一个
ACTIONS_STEP_DEBUG 值为 true,
下次运行的日志会多出细节。跑完记得删掉。
4 | 缓存与产物:两件常被混起来的事
| 缓存(cache) | 产物(artifact) |
| 目的是什么 | 加速:这次省掉重复下载 / 编译 | 留证据:这次生成的东西要能带出去 |
| 能不能依赖它存在 | 不能,随时可能没命中或被清理 | 能,只要还在保留期内 |
| 典型用途 | 把 node_modules、编译中间件存下来 | 把测试报告、日志、打包好的二进制上传 |
| 能不能跨作业传文件 | 不当这个用 | 可以,这是它唯一正当的跨作业传递方式 |
5 | 常见误解
- ① 「公开仓库免费,所以随便跑矩阵。」免费的是钱,额度与并发仍有上限,滥用会被限制。
- ② 「缓存命中是必然的。」key 不匹配、超过保留期、平台清理,都会让它没命中;流程必须能在没命中时也跑通。
- ③ 「日志里没报错,说明流程没问题。」要么它根本没被触发,要么失败发生在别的作业里 —— 先看运行列表,别看单条日志。
- ④ 「重跑一次就好了。」偶发的网络抖动确实会好,但如果每次都靠重跑,那是流程里有不确定的东西(版本漂移、外部服务不稳),要治。
- ⑤ 「产物会一直留着。」有保留期,过期就没;重要东西要另存。
6 | 练习
三题自测,每题只有一个正确选项;选完立刻看到解释。
1. 想在同分支连续推送时别把旧的那次跑完,可以用什么?
对。用 concurrency 给同一分支设一个组,新的一次会取消还在跑的旧的那次;路径过滤管的是「跑不跑」,不是「跑几次」。
2. 下面哪件事不该交给缓存来做?
对。缓存是「碰运气加速」,随时可能没命中或被清理;要留住生成物、还要跨作业传,那是产物(artifact)的活。
3. 流程红了,第一步最该确认什么?
对。没被触发、被路径过滤掉、定时任务被停用,都会表现为「什么都没发生」;先排除这一层,再进到日志。