如何在依赖Job失败时使test_finish Job失败并配置分支规则

我有一个测试工作流，结构如下：

jobs:
  set_matrix:
    . . .  # 定义测试环境
  test:
    needs: set_matrix
    . . .  # 以N个并行任务运行，每个任务在一个测试环境中执行测试
  test_finish:
    needs: test
    . . .  # 所有并行测试任务完成后运行，执行诸如收尾coveralls之类的操作

我想在master分支开启自动合并，需要可靠检测测试工作流是否成功，希望通过分支规则指定一个必填Job来实现。由于set_matrix定义的测试环境可能变化，我不想在分支规则中要求每个test Job都成功，仅要求test_finish Job成功。

但实际情况是：当一个或多个test Job失败时，test_finish会被跳过，而分支规则会将跳过的Job视为成功，导致PR在test Job失败的情况下仍被自动合并（已验证此问题）。

我尝试了两种方法但都无效：

1. 在test_finish中使用failure()：

jobs:
  set_matrix:
    . . .
  test:
    needs: set_matrix
    . . .
  test_finish:
    needs: test
    if: "!cancelled()"  # 除工作流被取消外始终运行 - 此部分生效
    steps:
      - name: 若有测试任务失败则终止
        if: failure()  # 此部分不生效
        run: exit 1
      . . .

根据文档，failure()会在任何前置步骤或祖先Job失败时返回true，但实际在test Job失败时并未返回true。

2. 在test Job中添加标记步骤：

jobs:
  set_matrix:
    . . .
  test:
    needs: set_matrix
    steps:
      . . .
      - name: 标记任务结果  # 任务的最后一步
        id: test_result
        run: exit 0
  test_finish:
    needs: test
    if: "!cancelled()"  # 除工作流被取消外始终运行 - 此部分生效
    steps:
      - name: 若有测试任务失败则终止
        if: steps.test_result.outcome != 'success'  # 此部分不生效
        run: exit 1
      . . .

此方法会导致test_finish中的检查步骤始终失败，即使所有test Job都成功，且不清楚如何处理多个test Job的test_result步骤结果。

我的问题是：

• 如何在一个或多个test Job失败时使test_finish Job失败？
• 更通用的：在包含set_matrix和N个并行test Job的场景中，如何配置分支规则，无需指定每个test Job，即可正确检测所有test Job和test_finish Job是否成功？

一、让test_finish在任意test Job失败时自动失败 #

核心思路是利用GitHub Actions的**needs上下文的result属性**，它会自动汇总所有依赖Job的整体状态：只要有一个依赖Job失败，needs.test.result就会是failure；只有所有依赖Job都成功时，才会是success。

修改test_finish的配置如下：

jobs:
  set_matrix:
    ... # 你的测试环境定义逻辑
  test:
    needs: set_matrix
    ... # 并行测试的逻辑
  test_finish:
    needs: test
    # 除工作流被取消外，始终执行该任务
    if: ${{ !cancelled() }}
    steps:
      - name: 检查所有测试任务的状态
        # 如果任意test任务失败，就终止test_finish并标记为失败
        if: ${{ needs.test.result != 'success' }}
        run: exit 1
      # 后续的收尾操作，比如提交coveralls报告
      - name: 完成coveralls
        run: ...

原理说明： #

• needs.test.result是GitHub Actions提供的上下文变量，针对并行的test Job，它会自动汇总所有实例的状态：
  • 所有test Job成功 → 返回success
  • 任意test Job失败 → 返回failure
  • 任意test Job被跳过 → 返回skipped（可根据需求决定是否处理这种场景）
• 通过if条件判断该状态，如果不是success就执行exit 1，直接让test_finish标记为失败，避免分支规则误判。

二、配置分支规则实现可靠检测 #

只需要在master分支的保护规则中，将**test_finish设置为必填检查**即可，无需添加所有test Job或set_matrix。

为什么这样可行： #

1. set_matrix是test的前置Job，如果set_matrix失败，test Job不会执行，此时needs.test.result会是failure，test_finish会执行检查步骤并失败，分支规则会拦截自动合并。
2. 任意test Job失败时，test_finish会被标记为失败，分支规则的必填检查会生效，阻止PR自动合并。
3. 只有当set_matrix成功、所有test Job成功、test_finish完成所有收尾操作时，test_finish才会标记为成功，满足分支规则的要求，允许自动合并。

内容的提问来源于stack exchange，提问作者Andreas Maier