复用GitHub Action工作流时作业输出参数传递为空问题排查

复用工作流完全支持接收来自其他作业输出的上下文变量，你遇到的USERNAME_TEST为空、UploadType正常的情况，大概率是输出定义或参数传递的细节出错了，下面是具体排查和解决步骤：

1. 检查源作业的输出定义是否完整 #

确保access-variables作业里，USERNAME_TEST的输出被正确声明和传递：

• 首先，步骤中要通过GITHUB_OUTPUT（推荐）或set-output（旧方式）正确设置输出值：

  steps:
    - name: 设置USERNAME_TEST
      id: set-username
      run: echo "USERNAME_TEST=your-username" >> $GITHUB_OUTPUT
    - name: 设置UploadType
      id: set-type
      run: echo "UploadType=release" >> $GITHUB_OUTPUT
  

• 然后，作业的outputs部分必须明确引用对应步骤的输出：

  jobs:
    access-variables:
      outputs:
        USERNAME_TEST: ${{ steps.set-username.outputs.USERNAME_TEST }}
        UploadType: ${{ steps.set-type.outputs.UploadType }}
      # 步骤代码...
  

对比UploadType的定义，确认USERNAME_TEST的作业输出声明没有遗漏或拼写错误。

2. 检查复用工作流的参数传递与输入声明 #

• 调用复用工作流时，必须通过needs上下文正确引用源作业的输出：

  jobs:
    call-create-package:
      needs: access-variables
      uses: ./CreatePackage.yml
      with:
        username: ${{ needs.access-variables.outputs.USERNAME_TEST }}
        upload-type: ${{ needs.access-variables.outputs.UploadType }}
  

• 同时，复用工作流CreatePackage.yml的workflow_call部分必须正确声明对应的输入参数：

  # CreatePackage.yml
  name: 创建包
  on:
    workflow_call:
      inputs:
        username:
          type: string
          required: true
        upload-type:
          type: string
          required: true
  jobs:
    package-job:
      runs-on: ubuntu-latest
      steps:
        - run: echo "用户名: ${{ inputs.username }}, 上传类型: ${{ inputs.upload-type }}"
  

注意输入参数的名称要和调用时的键完全匹配，大小写敏感。

3. 排查拼写与上下文引用错误 #

• 检查所有环节的变量名拼写：USERNAME_TEST的大小写、作业名access-variables、步骤id（比如set-username）是否在所有引用处完全一致。
• 确认调用复用工作流的作业依赖了access-variables（通过needs: access-variables），否则无法获取其输出。

4. 特殊情况：输出值含特殊字符 #

如果USERNAME_TEST的输出值包含空格、引号或特殊符号，设置输出时可以用单引号包裹内容避免解析错误：

run: echo 'USERNAME_TEST="user with space"' >> $GITHUB_OUTPUT

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