如何确保GitHub Actions中my-job获取对应矩阵实例的正确输出？

当依赖的作业是矩阵任务时，直接通过needs.<job-id>.outputs访问输出会拿到最后完成的实例值——因为所有矩阵实例的输出会被合并覆盖。要让my-job的每个矩阵实例获取对应some-job实例的输出，需要通过矩阵实例索引访问独立输出。

方案1：通过索引关联矩阵实例 #

直接基于some-job的矩阵索引构建my-job的矩阵，按索引获取对应实例的输出：

jobs:
  some-job:
    uses: some/action@v1
    strategy:
      matrix:
        env:
          [
            {input_param: valueA, appenv: production},
            {input_param: valueB, appenv: production}
          ]

  my-job:
    needs: some-job
    if: needs.some-job.result == 'success'
    strategy:
      # 遍历some-job矩阵的实例索引（索引从0开始，和矩阵定义顺序一致）
      matrix:
        index: [0, 1]
    env:
      # 获取对应索引的输入参数（可选，用于验证匹配关系）
      TARGET_INPUT: ${{ needs.some-job.matrix.env[matrix.index].input_param }}
      # 通过索引访问对应实例的输出
      MY_OUTPUT: ${{ needs.some-job.instances[matrix.index].outputs.example-output }}
    run: |
      echo "匹配输入参数: $TARGET_INPUT"
      echo "对应输出值: $MY_OUTPUT"

方案2：复用原矩阵配置并自动匹配索引 #

如果不想手动维护索引列表，可以复用some-job的矩阵配置，通过indexOf函数自动获取当前实例的索引：

jobs:
  some-job:
    uses: some/action@v1
    strategy:
      matrix:
        env:
          [
            {input_param: valueA, appenv: production},
            {input_param: valueB, appenv: production}
          ]

  my-job:
    needs: some-job
    if: needs.some-job.result == 'success'
    strategy:
      # 直接复用some-job的矩阵配置
      matrix:
        env: ${{ needs.some-job.matrix.env }}
    env:
      # 获取当前矩阵实例在原矩阵中的索引
      INSTANCE_INDEX: ${{ indexOf(needs.some-job.matrix.env, matrix.env) }}
      # 通过索引访问对应实例的输出
      MY_OUTPUT: ${{ needs.some-job.instances[INSTANCE_INDEX].outputs.example-output }}
    run: echo "$MY_OUTPUT"

关键原理说明 #

• GitHub Actions中，矩阵任务的所有实例会生成独立的输出集合，存储在needs.<job-id>.instances数组中，数组顺序和矩阵定义的顺序一致，与实例完成时间无关。
• 直接访问needs.<job-id>.outputs.<output-name>时，系统会返回最后一个完成的实例的输出值，这就是你遇到的覆盖问题。
• 通过instances[index].outputs可以精准定位到对应矩阵实例的输出，避免被后续完成的实例覆盖。

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