如何在GitHub可复用工作流中通过外部输入配置jobs.needs？

问题根源 #

GitHub Actions在解析工作流的job依赖（needs字段）时处于静态配置阶段，此时inputs这类运行时输入参数还未完成初始化，直接在needs中引用${{ inputs.jobDependencies }}会触发Unrecognized named-value: 'inputs'错误。

解决方案：使用fromJSON解析输入的JSON格式依赖 #

通过将依赖配置以合法JSON字符串的形式传入，再用fromJSON函数转换为needs支持的格式（单个job名称字符串或job名称数组），绕过静态解析限制。

1. 调整可复用工作流（Template.yml）的输入定义

on:
  workflow_call:
    inputs:
      jobName:
        required: true
        type: string
      jobDependencies:
        required: true
        type: string
        description: "传入JSON格式的依赖job列表，示例：'[\"build\", \"test\"]'（单个job用'[\"job-name\"]'）"

jobs:
  deployNotebook:
    name: ${{ inputs.jobName }}
    # 用fromJSON将输入的字符串转为needs支持的格式
    needs: ${{ fromJSON(inputs.jobDependencies) }}
    runs-on: ubuntu-latest
    steps:
      - name: 执行部署
        run: echo "开始部署Notebook"

2. 在调用工作流（Workflow.yml）中传入合法参数

jobs:
  call-deploy-template:
    uses: ./.github/workflows/Template.yml
    with:
      jobName: "部署Notebook"
      # 传入JSON数组格式的依赖，用单引号包裹避免YAML解析冲突
      jobDependencies: '["build", "test"]'
      # 如果是单个依赖，传入：'["build"]'

注意事项 #

• 输入的jobDependencies必须是合法的JSON格式，数组或带引号的单个字符串都可被fromJSON正确解析。
• 调用时必须用单引号包裹JSON字符串，防止YAML将内部双引号识别为语法边界。

备选方案（固定依赖场景） #

如果依赖组合是固定的几个选项，可将jobDependencies设为枚举类型，通过条件判断映射依赖：

on:
  workflow_call:
    inputs:
      jobName:
        required: true
        type: string
      jobDependencies:
        required: true
        type: choice
        options:
          - "仅build"
          - "build+test"
          - "仅test"

jobs:
  deployNotebook:
    name: ${{ inputs.jobName }}
    needs: ${{ inputs.jobDependencies == '仅build' && 'build' || inputs.jobDependencies == 'build+test' && ['build', 'test'] || 'test' }}
    runs-on: ubuntu-latest
    steps:
      - run: echo "部署执行中"

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