CI/CD / 系统课时

处理失败后仍需执行的步骤

处理失败后仍需执行的步骤

流水线失败时,最需要保留下来的往往正是失败现场。本节使用 GitHub Actions 的状态检查函数,让日志收集、测试报告上传和清理步骤在前序任务失败后仍按预期执行,同时避免把真正的失败误判成成功。

学习目标

  • 理解默认成功条件为何会跳过失败后的步骤
  • 使用 failure()、always() 和 cancelled() 控制执行条件
  • 为日志收集与清理设计不会掩盖原始故障的处理逻辑

为什么失败后的步骤会被跳过

GitHub Actions 的步骤可以通过 if 表达式决定是否运行。没有显式编写状态检查时,普通后续步骤实际上受到成功状态约束:前面的关键步骤失败后,后面的普通步骤通常不会继续执行。

这对构建流程合理,但对诊断流程并不合适。例如测试失败后,如果上传测试报告的步骤也被跳过,最终只知道“测试失败”,却失去了定位具体用例的证据。

根据状态选择后续动作

常用状态检查函数承担不同职责:failure() 适合只在失败时执行诊断;always() 适合无论成功或失败都需要执行的收尾工作;cancelled() 用于判断工作流或作业是否已经取消。

下面的工作流故意让测试步骤失败,以观察后续步骤的行为。上传日志使用 failure(),清理使用 always();示例中的命令只模拟这些动作,因此可以直接运行而不依赖额外文件。

yaml
name: failure-handling

on:
  workflow_dispatch:

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Run tests
        run: |
          echo "running tests"
          exit 1

      - name: Collect failure logs
        if: ${{ failure() }}
        run: echo "collect diagnostic logs"

      - name: Cleanup
        if: ${{ always() }}
        run: echo "cleanup temporary resources"

预期结果

text
Run tests: failure
Collect failure logs: success
Cleanup: success
Job result: failure

界面显示的具体时间与日志前缀可能不同,但关键结果应一致:测试失败后两个处理步骤仍运行,整个作业仍保持失败状态。

失败后步骤的条件执行流程

failure 与 always 不可互换

failure() 表达的是“前序执行已经出现失败”,所以适合收集错误日志、保存崩溃信息或执行失败通知。成功路径没有诊断需求时,这些步骤不必运行。

always() 更强:即使前面的步骤失败,它仍会尝试执行。因此它适合必须收尾的轻量操作,但不应机械地用于所有步骤。特别是可能长时间等待外部资源的关键操作,应谨慎使用无条件执行策略。

如果希望某个收尾步骤在成功和失败时运行、但取消后不继续,可以显式组合条件:

yaml
- name: Cleanup unless cancelled
  if: ${{ !cancelled() }}
  run: echo "cleanup after normal completion or failure"

预期结果

text
cleanup after normal completion or failure

当作业未被取消时会执行该命令;取消情况下该步骤不会运行。实际 Actions 页面还会显示对应步骤的执行或跳过状态。

不要掩盖真正的失败

状态检查函数控制的是后续步骤是否运行,并不意味着应该忽略核心步骤的错误。测试或部署失败后,日志收集可以成功,原始失败仍应保留下来,使提交检查明确显示流水线存在问题。

设计失败处理时,可以把步骤分成三类:核心验证失败应使作业失败;故障证据只在失败时收集;必要清理根据是否允许取消后继续执行,选择 always() 或 !cancelled()。这样既能留下诊断信息,也不会把红灯错误地变成绿灯。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

处理失败后仍需执行的步骤

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通